量子

弃用通知

该存储库已被弃用。

有关 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