使用Bicep时Azure Verified Modules智能提示无法解析模块列表

问题场景 #

在VS Code中使用Bicep调用Azure Verified Modules（AVM）时，输入br/public:触发智能提示时出现报错：解析别名‘public’后的OCI artifact引用‘br:mcr.microsoft.com/bicep/’无效，路径段‘bicep/’不符合命名规则。但手动补全完整模块引用（如module nsg 'br/public:avm/res/network/network-security-group:0.1.3' = {}）时，模块可正常下载到.bicep\br文件夹。使用版本：Azure CLI 2.60.0、Bicep 0.26.170、VS Code 1.88.1、Bicep扩展0.26.170。

原因分析 #

• 核心问题是public别名对应的基础路径末尾带有斜杠（mcr.microsoft.com/bicep/），违反了OCI artifact的路径命名规范：OCI仓库路径段不能以斜杠结尾，也不能包含空的路径片段。当智能提示尝试解析别名基础路径时，末尾斜杠会被识别为空路径段，导致验证失败。
• 手动输入完整模块路径时，实际拼接后的路径是mcr.microsoft.com/bicep/avm/...，此时路径没有空片段，符合规范，因此可以正常拉取模块。

解决步骤 #

1. 检查当前别名配置
   打开终端运行以下命令，查看public别名的定义：

   bicep config get aliases.public
   

   如果输出结果是br:mcr.microsoft.com/bicep/（带末尾斜杠），说明配置有误。

2. 修正别名配置
   运行以下命令更新public别名，移除末尾的斜杠：

   bicep config set aliases.public br:mcr.microsoft.com/bicep
   

3. 重启VS Code
   关闭并重新打开VS Code，确保新的配置生效。之后在bicep文件中输入module test 'br/public:，即可正常触发智能提示，显示AVM模块列表。

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