針對 Bicep 安裝進行疑難排解

本文說明如何解決 Bicep 安裝中的潛在錯誤。

.NET 執行階段錯誤

安裝 Visual Studio Code 的 Bicep 延伸模組時，您可能會遇到下列錯誤訊息：

Failed to install .NET runtime v5.0

Failed to download .NET 5.0.x ....... Error!

警告

這是最後的解決方案，可能會在更新版本時造成問題。

若要解決此問題，您可以從 .NET 網站手動安裝 .NET，然後使用下列設定，將 Visual Studio Code 設定為重複使用現有的 .NET 安裝：

Windows

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "C:\\Program Files\\dotnet\\dotnet.exe"
  }
]

macOS

如果您需要 x64 安裝，請使用：

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/x64/dotnet"
  }
]

若是其他 macOS 安裝，請使用：

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/dotnet"
  }
]

如需設定 Visual Studio Code 設定的詳細資訊，請參閱使用者與工作區設定。

Visual Studio Code 錯誤

如果您在 Visual Studio Code 中看到下列錯誤訊息快顯：

The Bicep server crashed 5 times in the last 3 minutes. The server will not be restarted.

從 VS Code 開啟 畫面底部窗格中的 [輸出 ] 檢視，然後選取 [Bicep：]

如果您在窗格中看到下列輸出，而且您使用的是 Bicep CLI 0.4.1124 版或更新版本，請檢查您是否已將組 dotnetAcquisitionExtension.existingDotnetPath 態選項新增至 VS Code。 請參閱 .NET 執行階段錯誤。 如果此組態選項存在，請將其移除並重新啟動 VS Code。

It was not possible to find any compatible framework version.

否則，請在 Bicep 存放庫中提出問題並包含該輸出訊息。

安裝多個 Bicep CLI 版本

如果您將 Bicep CLI 手動安裝到一個以上的位置，您可能會注意到有非預期行為發生，例如當您執行 upgrade 命令時，Bicep CLI 並未更新。 或者，您可能會注意到執行 az bicep version 會傳回一個版本，但是執行 bicep --version 會傳回不同的版本。

若要解決此問題，您可以更新所有的位置，或是選取一個位置來保留，然後刪除其他的位置。

首先，開啟命令提示字元 (不是 PowerShell)，然後執行 where bicep。 此命令會傳回 Bicep 安裝的位置。 如果您使用 Azure CLI 管理的 Bicep CLI 執行個體，便不會看到此安裝，因為此安裝未新增至 PATH。 如果 where bicep 只傳回一個位置，則您看到的衝突版本可能是介於手動安裝與 Azure CLI 安裝之間。

若要保留所有安裝位置，請使用您稍早所用的相同方法，針對您想要保留的所有位置，手動安裝 Bicep CLI。 如果您使用的是 Azure CLI，請執行 az bicep upgrade 更新該版本。

若只保留一個安裝位置，請使用下列步驟：

1. 刪除您不想要保留的安裝檔案。
2. 從 PATH 環境變數中移除這些位置。

如果您同時具有手動安裝和由 Azure CLI 管理的執行個體，您可以結合為使用一個執行個體。

1. 刪除手動安裝位置。
2. 將 Azure CLI 安裝的 Bicep CLI 位置新增至 PATH 變數。 若是 Windows，由 Azure CLI 維護的位置是 %USERPROFILE%\.Azure\bin。

將 Azure CLI 執行個體新增至 PATH 後，您可以將該版本與 az bicep 或 bicep 搭配使用。

下一步

如需使用 Visual Studio Code 和 Bicep 延伸模組的詳細資訊，請參閱快速入門：使用 Visual Studio Code 建立 Bicep 檔案。