將 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