共用方式為


更新 Azure Quantum Development Kit 到最新版本

學習如何將Azure Quantum Development Kit(QDK)更新至最新版本。

必要條件

  • 本文假設你已經在 Visual Studio Code (VS Code) 安裝了這個 AzureQDK 擴充功能。 如果您是第一次安裝,請參閱 安裝指南

更新 VS Code 延伸模組

根據預設,VS Code 會自動更新延伸模組。 更新延伸模組之後,系統會提示您重新載入 VS Code。 若要停用自動更新並手動更新延伸模組,請參閱 VS Code 檔中的 延伸模組自動更新

更新 Azure Quantum Python 套件

重要

如果你是從之前Qiskit的環境更新,建議參考「在虛擬 Python 環境中更新qdk.azure模組並支援Qiskit」。

  1. 更新至最新的 qdk Python 函式庫,附上額外內容 azure

    pip install --upgrade "qdk[azure]"
    
  2. 為了添加對 Qiskit 電路的分析、轉換、程式碼生成和模擬的支援,安裝 qiskitjupyter 附加元件。

    pip install --upgrade "qdk[qiskit,jupyter]"
    

注意

QDK 支援 Qiskit 版本 1 和 2。

qdk.azureqdk.qiskit Python 模組包含可選的支援,以便建立並提交Qiskit 電路至 Azure Quantum。 當你安裝 qdk.azureqdk.qiskit 模組時,將預設安裝最新版本的 Qiskit,這可能會對現有的 Qiskit 環境造成問題。 為確保開發環境穩定,請建立虛擬 Python 環境並安裝qdk.azureqdk.qiskit於該虛擬環境中。

注意

如果你使用的 Qiskit 是版本 1,請參考 Qiskit 1.0 版本的封裝變更 ,以獲得更多關於封包相容性的資訊。

要建立虛擬 Python 環境並安裝 qdk.azureqdk.qiskit,請遵循以下步驟:

  1. 建立本機資料夾,例如 ~/qiskit10-env

  2. venv使用資料夾的路徑執行。

    python -m venv ~/qiskit10-env
    
  3. 啟用環境。

    ~/qiskit10-env/bin/activate
    
  4. 執行pip list命令,以查看新環境中只安裝核心套件。

  5. 要安裝 qdk.azure and qdk.qiskit 模組,請執行以下指令:

    pip install "qdk[azure,qiskit]"
    
  6. 視需要安裝您在先前環境中使用的其他套件。 在每個環境中執行這個 pip list 指令來比較套件和版本。

注意

您也可以在 VS Code 中開啟虛擬環境。 從 [ 檢視 ] 功能表中,選擇 [命令面板],然後輸入 Python:建立環境, 然後選擇 venv。 然後,選擇 [ 開啟資料夾...] ,然後選取您先前建立的環境資料夾。 如需在 VS Code 中使用環境的詳細資訊,請參閱 VS Code 中的 Python 環境。

在目前環境中更新 qdk.azure and qdk.qiskit 模組

你也可以在不使用虛擬環境的情況下更新 qdk.azure and qdk.qiskit 模組。 不過,現有環境中套件 qiskit 的更新可能會導致與其他套件發生相依性衝突。 欲了解更多封裝相容性的資訊,請參閱 Qiskit 1.0 封裝變更

要在你目前環境中更新 qdk.azure 和 模組 qdk.qiskit ,請完成以下步驟:

  1. 卸載現有 qdk 模組及其他 Qiskit 相依性:

    pip uninstall -y "qdk[azure,qiskit]" qiskit qiskit-terra qiskit-qir
    
  2. 重新安裝 qdk 庫並使用 qiskit 擴展套件:

    pip install "qdk[qiskit]"
    

更新 Azure CLI quantum 擴充功能

更新或安裝最新的 Azure CLI quantum 擴充功能。

  1. 開啟 Windows 命令提示字元。

  2. 從命令提示字元中,執行下列命令:

    az extension add --upgrade -n quantum