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

将 Azure Quantum Development Kit 更新到最新版本

了解如何将 Azure Quantum Development Kit (QDK) 更新到最新版本。

先决条件

  • 本文假定已在 Visual Studio Code(VS Code)中安装了 Azure QDK 扩展。 如果首次安装,请参阅 安装指南

更新 VS Code 扩展

默认情况下,VS Code 自动更新扩展。 更新扩展后,系统会提示重新加载 VS Code。 若要手动禁用自动更新和更新扩展,请参阅 VS Code 文档中的 扩展自动更新

更新 Azure Quantum Python 包

重要

如果要从以前的 Qiskit 环境进行更新,请参阅在虚拟 Python 环境中使用 Qiskit 支持更新 azure-quantum 包(建议)。

  1. 使用 Python 包安装程序更新到最新 qdk 包和 azure-quantum Python 包(pip)。

    pip install --upgrade qdk
    

    若要为 Qiskit 电路添加分析、转换、代码生成和模拟的支持,请安装可选的 qiskitwidget 包。

    pip install --upgrade qdk[qiskit,jupyter]
    
    pip install --upgrade azure-quantum
    

azure-quantum Python 包包括用于创建 Qiskit 线路并将其提交到 Azure Quantum 的可选支持。 使用 Qiskit 支持安装 azure-quantum 包时,该包将安装最新版本的 Qiskit,这可能会导致现有 Qiskit 环境出现问题。 若要确保稳定的开发环境,请创建虚拟 Python 环境并安装 azure-quantum 该环境。

若要创建虚拟 Python 环境并使用 Qiskit 支持安装 azure-quantum,请执行以下步骤:

  1. 创建本地文件夹,例如 ~/qiskit10-env

  2. 运行 venv 并提供文件夹的路径。

    python -m venv ~/qiskit10-env
    
  3. 激活该环境。

    ~/qiskit10-env/bin/activate
    
  4. 运行 pip list 以查看新环境中是否只安装了核心包。

  5. 若要安装 azure-quantum 包,请运行以下命令:

    pip install azure-quantum[qiskit]
    
  6. 根据需要安装以前环境中使用的其他包。 可以在每个环境中运行 pip list 以比较包和版本。

注意

有关包兼容性的详细信息,请参阅 Qiskit 1.0 打包更改

注意

还可以在 VS Code 中打开虚拟环境。 在 “视图 ”菜单中,选择 “命令面板”,然后输入 Python:创建环境 并选择 venv。 然后选择 “打开文件夹...” ,然后选择之前创建的环境文件夹。 有关在 VS Code 中使用环境的详细信息,请参阅 VS Code 中的 Python 环境。

在当前环境中将 azure-quantum 软件包更新为支持 Qiskit

还可以在不使用虚拟环境的情况下使用 Qiskit 支持更新 azure-quantum 包。 但是,对现有环境中的包的 qiskit 更新可能会导致与其他包发生依赖关系冲突。 有关包兼容性的详细信息,请参阅 Qiskit 1.0 打包更改

若要更新 azure-quantum 包,请完成以下步骤:

  1. 卸载现有 azure-quantum 包和 qiskit 包:

    pip uninstall -y azure-quantum qiskit qiskit-terra qiskit-qir
    
  2. 使用可选的qiskit附加项重新安装azure-quantum

    pip install azure-quantum[qiskit]
    

更新 Azure CLI quantum 扩展

更新或安装最新的 Azure CLI quantum 扩展。

  1. 打开 Windows 命令提示符。

  2. 在命令提示符下运行以下命令:

    az extension add \
        --upgrade \
        --name quantum