量子

棄用通知

該存儲庫已被棄用。

有關 Modern QDK 儲存庫，請造訪 Microsoft/qsharp。

有關使用 Azure Quantum Python 套件的範例，請造訪 Azure Quantum Python 儲存庫。

您也可以在 vscode.dev/quantum 上嘗試 VS Code for Web 中的現代 QDK。

有關現代 QDK 和 Azure Quantum 的更多信息，請訪問 https://aka.ms/AQ/Documentation。

經典QDK

這些範例示範如何使用量子開發套件執行各種不同的量子計算任務。

每個範例都獨立於一個資料夾中，並示範如何使用 Q# 開發量子應用程式。

除了 Quantum 開發套件的其餘部分之外，少數範例還具有額外的安裝要求。每個範例的 README.md 檔案中都記錄了這些內容，以及完整的安裝說明。

入門

您可以在我們的線上文件中找到有關如何安裝量子開發套件的說明，其中還包括量子程式設計概念的介紹。

有關如何使用 Visual Studio Code 或 GitHub Codespaces 從頭開始設定開發環境的快速指南，請參閱此處。

為了方便起見，還提供了 Docker 映像定義，請參閱此處以取得如何建置和使用它的說明。

第一批樣品

如果您是量子或量子開發套件的新手，我們建議您從入門範例開始。

使用上述選項之一設定開發環境後，請嘗試透過終端機瀏覽至samples/getting-started/teleportation並執行dotnet run 。您應該會看到類似以下內容：

 Round 1: Sent False, got False.
Teleportation successful!
Round 2: Sent True, got True.
Teleportation successful!
Round 3: Sent False, got False.
Teleportation successful!
Round 4: Sent False, got False.
Teleportation successful!
Round 5: Sent False, got False.
Teleportation successful!
Round 6: Sent False, got False.
Teleportation successful!
Round 7: Sent True, got True.
Teleportation successful!
Round 8: Sent False, got False.
Teleportation successful!

恭喜，您現在可以開始量子程式設計了！

更進一步

當您進一步進行量子開發時，我們提供了幾種不同類別的範例供您探索：

• 演算法：這些範例演示了各種量子演算法，例如資料庫搜尋和整數分解。
• 算術：這些範例顯示如何連貫地轉換算術資料。
• 表徵：這些範例示範如何從經典資料中學習量子系統的屬性。
• 化學：這些範例演示了量子化學庫的使用。
• 診斷：這些範例顯示如何診斷和測試 Q# 應用程式。
• 糾錯：這些範例展示如何在 Q# 程式中使用量子糾錯碼。
• 互通性：這些範例展示如何將 Q# 與不同的主機語言一起使用。
• 機器學習：這些範例示範如何在半月和葡萄酒資料集上訓練簡單的序列模型。
• Numerics ：此資料夾中的範例展示如何使用數位庫。
• 運行時：這些範例展示如何使用 Q# 模擬運行時。
• 模擬：這些範例顯示如何模擬不同哈密頓量下的演化。

我們也鼓勵查看用於檢查量子開發套件範例正確性的單元測試。

設定您的開發環境

該存儲庫包含多個配置文件，可以輕鬆開始編碼。下面我們列出了一些 VSCode 或 Jupyter Notebook 入門說明。

視覺工作室程式碼

如果您喜歡在本機上開發程式碼，我們建議您安裝 Visual Studio Code 等編輯器。確保在本機上安裝 .NET Core SDK 3.1 或更高版本。有關如何設定 VS Code 以使用 QDK 進行開發的更多詳細說明，請參閱此處的文件。

安裝 VS Code 和 .NET Core SDK 後，將此儲存庫下載到您的電腦並在 VS Code 中開啟該資料夾。編輯器將自動識別.vscode資料夾中的檔案並要求您安裝建議的擴充功能。其中包括 Microsoft Quantum Development Kit for Visual Studio Code 擴展，這是開始使用 QDK 的最快方式。

打開終端機開始運行您的第一個範例（請參閱此處）。

使用 Docker 運行 Jupyter Notebook

在 Q# 中快速開始開發的另一種方法是使用 Docker 並在本機電腦上啟動 Jupyter Notebook。您可以使用隨附的 Dockerfile 建立一個包含所有必要程式庫的 Docker 映像，以便使用量子開發套件在 C#、Python 或 Jupyter 中建立量子應用程式。

安裝 Docker 後，您可以使用以下命令開始使用：

要建立 docker 映像並將其標記為iqsharp ：

docker build -t iqsharp .

若要使用互動式命令列執行名為iqsharp-container的容器中的映像，並將容器連接埠 8888 重新導向至本機連接埠 8888（執行 jupyter 需要）：

docker run -it --name iqsharp-container -p 8888:8888 iqsharp /bin/bash

從對應的容器命令列，您可以使用下列命令執行 Teleportation 範例的 C# 版本：

 cd ~ /samples/getting-started/teleportation && dotnet run

同樣，您可以使用以下命令運行 Teleportation 範例的 Python 版本：

 cd ~ /samples/getting-started/teleportation && python host.py

最後，要在 Teleportation 範例的圖像中啟動 Jupyter Notebook，請使用：

 cd ~ /samples/getting-started/teleportation && jupyter notebook --ip=0.0.0.0 --no-browser 

Jupyter 啟動後，您可以在瀏覽器中開啟 Teleportation 筆記本（您將需要 jupyter 在上一個步驟啟動時產生的令牌）：

http://localhost:8888/notebooks/Notebook.ipynb

完成後，刪除名為iqsharp-container容器：

docker rm --force iqsharp-container