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]。
