通过

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

Visual Studio Code 输出窗格

如果在窗格中看到以下输出，请检查是否已将 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 以更新该版本。

若要仅保留一个安装位置，请执行以下步骤：

  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 文件。