QuantumKatas
velopment Kit 0.5
我們正在現代化量子Katas體驗。請訪問https://quantum.microsoft.com/experience/quantum-katas在Azure Quantum中的Copilot綜合協助下，嘗試新的在線Azure Quantum Katas體驗。
對於現代QDK存儲庫，請訪問Microsoft/QSHARP。
有關現代QDK和Azure量子的更多信息，請訪問https://aka.ms/aq/documentation。
量子katas是一個自定進度教程和編程練習的集合，可幫助您學習量子計算和Q＃編程。
每個Kata都是一組單獨的練習，其中包括：
量子katas還包括將學習者介紹量子計算中使用的基本概念和算法的教程，從必要的數學（複數和線性代數）開始。他們遵循相同的模式，以Q＃演示和動手編程練習來補充理論。
這是我們建議您遵循的學習路徑，如果您開始學習量子計算和量子編程。一旦您對基礎知識感到滿意，歡迎您跳入引起您興趣的主題！
有關Q＃編程語言快速參考表，請參見Q＃語言快速參考。
現在可以在線使用Quantum Katas作為Jupyter筆記本！有關所有KATA和教程的列表，請參見index.ipynb，以及在線運行的說明。
請注意，MyBinder.org的容量減小，因此可以使用虛擬機並在其上啟動筆記本，可能需要進行幾次嘗試。當在線運行Katas是最簡單的開始時，如果您想節省進度並享受更好的性能，我們建議您選擇本地設置選項。
要在本地使用量子katas，您將需要Windows 10，MacOS和Linux的量子開發套件。如果您尚未安裝量子開發套件，請參閱“量子開發套件的安裝指南”。
如果您想在本地運行katas和jupyter筆記本：
pytest包。matplotlib軟件包。matplotlib和numpy軟件包。請參閱更新智商＃內核，以將智商＃內核更新為帶有每月QDK版本的新版本。
如果您想在Q＃項目中在本地運行Katas和教程：
請按照QDK安裝指南，Visual Studio，Visual Studio代碼或其他編輯器的步驟進行操作。
在本地運行Katas的Q＃項目需要下載和安裝.NET 6.0 SDK。即使您安裝了另一個.NET版本，也可以執行此操作，因為並排支持多個版本。
由於Visual Studio 2019不支持.NET 6.0項目，因此您需要升級到Visual Studio 2022並安裝相應的Microsoft Quantum開發套件擴展名。
如果您安裝了git，請克隆Microsoft/Quantumkatas存儲庫：
$ git clone https://github.com/Microsoft/QuantumKatas.git提示
Visual Studio 2022和Visual Studio代碼都可以輕鬆地從開發環境中克服存儲庫。有關詳細信息，請參閱Visual Studio和Visual Studio代碼文檔。
如果您沒有安裝git，請從https://github.com/microsoft/quantumkatas/archive/main.zip下載Katas。
作為jupyter筆記本電腦運行katas的最佳方法是導航到存儲庫的根文件夾，並使用jupyter打開index.ipynb ：
$ cd QuantumKatas/
$ jupyter notebook index.ipynb這將打開包含所有katas和教程列表的筆記本，您將能夠導航到想要使用鏈接的列表。
注意：這將在您用於運行命令的同一命令行窗口中啟動jupyter筆記本服務器。如果要繼續使用該窗口進行導航，則可以使用以下命令在新窗口中啟動Jupyter Notebooks Server：
對於Windows：
$ cd QuantumKatas/ $ start jupyter notebook index.ipynb對於Ubuntu：
$ cd QuantumKatas/ $ gnome-terminal -- start jupyter notebook index.ipynb
您也可以直接打開單獨的筆記本，但這可能會使內部鏈接無效：
$ cd QuantumKatas/tutorials/ComplexArithmetic
$ jupyter notebook ComplexArithmetic.ipynb每個kata都是一個獨立的Q＃項目，解決方案和jupyter筆記本電腦三重態的目錄。例如，BasicGates目錄結構是：
QuantumKatas/
BasicGates/
README.md # Instructions specific to this kata.
.vscode/ # Metadata used by Visual Studio Code.
BasicGates.sln # Visual Studio solution file.
BasicGates.csproj # Project file used to build both classical and quantum code.
BasicGates.ipynb # Jupyter Notebook front-end for this kata.
Workbook_BasicGates.ipynb # Jupyter Notebook workbook for this kata.
Tasks.qs # Q# source code that you will fill as you solve each task.
Tests.qs # Q# tests that verify your solutions.
ReferenceImplementation.qs # Q# source code containing solutions to the tasks.要打開Visual Studio 2022中的基本蓋kata，請打開Quantumkatas/basicalgates/basicgates.sln解決方案文件。
要在Visual Studio代碼中打開BasicGates Kata，請打開Quantumkatas/ basicalgates/文件夾。按Ctrl + Shift + P （或MacOS上的⌘ + Shift + P ）打開命令調色板。在Windows 10或Linux上鍵入打開文件夾或在MacOS上打開。
提示
Visual Studio代碼中幾乎所有可用的命令都在命令調色板中。如果卡住了，請按Ctrl + Shift + P （或MacOS上的⌘ + Shift + P ），然後開始鍵入以搜索所有可用命令。您還可以從命令行啟動Visual Studio代碼：
$ code QuantumKatas/BasicGates/
打開Kata後，是時候使用以下說明進行測試了。最初，所有測試都會失敗。不要恐慌！打開tasks.qs並開始填寫代碼以完成任務。每個任務均由單位測試涵蓋。填寫任務的正確代碼後，重建項目並重新運行測試，相應的單元測試將通過。
cd命令導航到包含 *.csproj文件的文件夾。dotnet test 。這應該構建KATA項目並運行所有單元測試。所有單元測試都應失敗。dotnet test中。為方便起見，一個任務。每個Kata都存在JSON配置文件。它允許Visual Studio代碼從命令調色板運行構建和測試步驟。按Ctrl + Shift + P （或MacOS上的⌘ + shift + P ）打開調色板，然後鍵入運行構建任務或運行測試任務，然後按Enter 。
您可以使用隨附的Dockerfile使用所有必要的工具來創建Docker Image，以從命令行或Jupyter運行Katas。
katas ： docker build -t katas .katas-container的容器中，並帶有交互式命令行，並重定向容器端口8888到本地端口8888 （需要運行jupyter）： docker run -it --name katas-container -p 8888:8888 katas /bin/bash cd ~ /BasicGates/
dotnet test cd ~ /BasicGates/ && jupyter notebook --ip=0.0.0.0 --no-browser http://localhost:8888/notebooks/BasicGates.ipynb
要在不殺死它的情況下退出Docker容器（守護程序模式），請按Ctrl+P，Ctrl+Q
重新輸入現有的katas-container （在守護程序模式下）：
docker attach katas-container完成後，刪除katas-container ：
docker rm --force katas-container該項目歡迎貢獻和建議。看看我該如何貢獻？有關詳細信息。
該項目採用了Microsoft開源的行為代碼。有關更多信息，請參見《行為守則常見問題守則》或與其他問題或評論聯繫[email protected]。
