你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

设置 Microsoft Quantum 开发工具包

本文介绍如何安装 Visual Studio Code (VS Code)的 Microsoft Quantum 开发工具包 (QDK) 扩展、Jupyter Notebook支持的 QDK Python 包以及Azure CLI。

先决条件

安装 QDK 扩展

若要在 VS Code 中使用 QDK,请安装 QDK 扩展。 还可以在 VS Code 中 将 QDK 用于 Web ,而无需安装扩展,但你没有 VS Code Desktop 的所有功能。 有关详细信息,请参阅 运行 Q# 程序的不同方法。

现在可以针对内置量子模拟器编写、调试和运行 Q# 程序。 或者,如果你有一个 Azure 帐户,你可以从 VS Code 连接到量子硬件并提交 Q# 程序。

若要测试设置,请参阅 将作业提交 Q# 到 Azure Quantum。

安装 QDK Python 包

借助 VS Code 中的 Python 支持,你可以从 Python 程序或 Jupyter 笔记本中嵌入或调用 Q# 代码,并在内置量子模拟器上运行它们。 还可以连接到 Azure Quantum 工作区,并提交作业以在真实量子硬件上运行。

先决条件

  • 使用 Python 和 Pip 安装 Python 环境(3.10 或更高版本,建议使用 3.11)。
  • 在 VS Code 中安装 QDK 扩展。

安装必需包

提供对 Python 和 Jupyter Notebook 的支持:

  1. 安装适用于 VS Code 的 Python 和 Jupyter 扩展。

  2. 打开命令行。

  3. 安装具有 azure 附加组件的 qdk Python 包:

    python -m pip install "qdk[azure]"
    
  4. 对于 Qiskit 版本 1 和版本 2 的支持,请安装 qiskit 额外依赖包。

    python -m pip install "qdk[qiskit]"
    

    重要

    如果要从以前的 Qiskit 环境更新,请参阅 使用 Qiskit 支持更新 qdk.azure 模块。

  5. 若要在 Jupyter Notebook 中工作并显示可视化效果,请安装以下 Python 包:

    python -m pip install "qdk[jupyter]" ipykernel ipympl jupyterlab
    
  6. 对于量子误差更正功能,请安装 ec 扩展包(需要 Python 3.11 或更高版本)。

    python -m pip install "qdk[ec]"
    

    有关如何安装和使用该 qdk.ec 模块的详细信息,请参阅 如何安装 QDK 以进行纠错。

若要测试您的设置,请参阅使用 Python 提交作业Q#或使用 Jupyter Notebooks 提交作业。

添加对 Azure CLI 的支持

可以选择使用 Azure CLI 从 VS Code 中的终端窗口提交量子作业。

  1. 安装 Azure CLI。

  2. 在 VS Code 中打开 Windows 命令提示符或终端。

  3. 在命令提示符下运行以下命令以更新到最新的 Azure CLI quantum 扩展:

    az extension add --upgrade -n quantum
    

若要测试设置,请参阅 将作业提交 Q# 到 Azure Quantum。