更新 Microsoft Quantum Development Kit 到最新版本

學習如何將Microsoft Quantum Development Kit（QDK）更新至最新版本。

必要條件

  • 本文假設你已經在 Visual Studio Code （VS Code） 安裝了這個 QDK 擴充功能。 如果你是第一次安裝，請參考 「安裝擴充 QDK 功能」。

更新 VS Code 延伸模組

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

更新 QDK Python 函式庫

重要

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

  1. 將 qdk Python 套件更新至最新版本，並包含 azure 額外功能：

    pip install --upgrade "qdk[azure]"

  2. 為了添加對 Qiskit 電路的分析、轉換、程式碼生成和模擬的支援，安裝 qiskit 和 jupyter 附加元件。

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

注意

QDK 支援 Qiskit 版本 1 和 2。

qdk.azure 和 qdk.qiskit Python 模組包含可選的支援，以便建立並提交Qiskit 電路至 Azure Quantum。 當你安裝 qdk.azure 和 qdk.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. 使用 qiskit 額外功能重新安裝 qdk 套件：

    pip install "qdk[qiskit]"

更新 Azure CLI quantum 擴充功能

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

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

  2. 從命令提示字元中，執行下列命令：

    az extension add --upgrade -n quantum
  • 上次更新時間：