針對 Bicep 安裝進行疑難排解
本文說明如何解決 Bicep 安裝中的潛在錯誤。
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:]
如果您在窗格中看到下列輸出,請檢查您是否已將設定新增 dotnetAcquisitionExtension.existingDotnetPath
至 VS Code。 如果存在此設定,請將其移除並重新啟動 VS Code。 如需設定 Visual Studio 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
更新該版本。
若只保留一個安裝位置,請使用下列步驟:
- 刪除您不想要保留的安裝檔案。
- 從 PATH 環境變數中移除這些位置。
如果您同時具有手動安裝和由 Azure CLI 管理的執行個體,您可以結合為使用一個執行個體。
- 刪除手動安裝位置。
- 將 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 檔案。