Visual Studio Code报Bicep参数错误但Azure CLI运行正常的求助

问题现象 #

编写了包含.bicepparams参数文件的Bicep代码，在Visual Studio Code中对该参数文件执行validate或what-if操作时，持续提示「未提供模板参数值」，即使为主模板（troubleshoot_main.bicep）中的参数添加默认值，仍会依次报错下一个参数缺失；但使用完全相同的文件通过Azure CLI执行验证时却成功：

az deployment sub validate --template-file troubleshoot_main.bicep --parameters troubleshoot_main.bicepparam --location westeurope | jq .properties.provisioningState    
"Succeeded"

排查与解决步骤 #

• 更新Bicep扩展到最新版本
  旧版VS Code Bicep扩展对.bicepparams文件的解析支持存在兼容性问题。打开VS Code扩展面板，搜索「Bicep」，检查并更新到最新版本后重试操作。

• 确认部署作用域与位置配置
  主模板的targetScope为subscription，VS Code执行验证时需确保作用域匹配：

  1. 打开.bicepparams文件，点击右上角操作按钮旁的下拉菜单；
  2. 选择「Subscription」级部署，并指定与CLI一致的位置（如westeurope）。

• 检查工作区路径与参数文件引用
  确保VS Code打开的工作区根目录与执行CLI时的当前目录一致，同时确认.bicepparams中using './troubleshoot_main.bicep'的路径引用正确，避免因路径解析错误导致参数无法关联主模板。

• 清理Bicep缓存
  扩展缓存可能导致模板解析异常：

  1. 打开命令面板（Ctrl+Shift+P）；
  2. 执行「Bicep: Clean Bicep Cache」命令；
  3. 重启VS Code后重新验证。

• 重置Bicep相关设置
  在VS Code设置中搜索「Bicep」，将所有Bicep相关配置重置为默认值，排查是否有自定义设置干扰参数解析。

内容的提问来源于stack exchange，提问作者Hannes