你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

排查 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”：

Visual Studio Code 输出窗格

如果在窗格中看到以下输出，且正在使用 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. 向 PATH 变量中添加由 Azure CLI 安装的 Bicep CLI 的位置。 对于Windows，由 Azure CLI 维护的位置为 %USERPROFILE%\.Azure\bin。

将 Azure CLI 实例添加到 PATH 后，可以通过 az bicep 或 bicep 使用该版本。

后续步骤

有关使用 Visual Studio Code 和 Bicep 扩展的详细信息，请参阅快速入门：使用 Visual Studio Code 创建 Bicep 文件。