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

将 Azure Quantum Development Kit (新式 QDK) 更新到最新版本

了解如何将新式 QDK 更新到最新版本。

先决条件

• 本文假定已安装新式 QDK。 如果是首次安装，请参阅安装指南。

• 如果使用的程序需要 Microsoft Quantum Development Kit (经典 QDK) （如混合集成计算），请参阅 继续使用经典 QDK。

更新 Visual Studio Code 扩展

默认情况下，Visual Studio Code自动更新扩展。 进行任何更新后，系统将提示你重新加载 VS Code。 如果希望手动禁用自动更新和更新扩展，请参阅 VS Code 文档中的 扩展自动更新 。

更新 Azure Quantum Python 包

重要

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

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

   pip install --upgrade qsharp>=1.0
   

   pip install --upgrade azure-quantum
   

在虚拟 Python 环境中使用 Qiskit 支持更新 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

   python3 -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 环境。

在当前环境中使用 Qiskit 支持更新 azure-quantum 包

还可以使用 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 量子扩展

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

   az extension add --upgrade --name quantum