如何抑制Bicep Linter的BCP104：引用模块存在错误？

问题背景 #

你试过在父模块里用#disable-next-line use-recent-api-versions注释来抑制子模块的API版本规则错误，但完全没用——只有直接在子模块文件里加抑制注释才生效。现在构建里一堆BCP104: The referenced module has errors错误，想找办法忽略这些问题。

可行解决办法 #

1. 给特定子模块单独改规则配置（推荐） #

在项目的.bicepconfig.json里，针对子模块路径单独调整规则级别，比如把use-recent-api-versions设为off或者warning：

{
  "analyzers": {
    "core": {
      "enabled": true,
      "verbose": false,
      "rules": {
        // 保留你原来的所有规则配置
        "use-recent-api-versions": {
          "level": "error"
        }
      },
      "ruleOverrides": [
        {
          "filePaths": ["dependencies/module.bicep"],
          "rules": {
            "use-recent-api-versions": {
              "level": "off"
            }
          }
        }
      ]
    }
  }
}

这样只会对指定的子模块禁用这个规则，不会影响其他文件的Lint检查。

2. 直接禁用BCP104错误（谨慎用） #

要是你只想屏蔽所有BCP104的提示，也可以在配置里加这个规则的覆盖：

{
  "analyzers": {
    "core": {
      "enabled": true,
      "verbose": false,
      "rules": {
        // 原有规则不变...
        "referenced-module-has-errors": {
          "level": "off"
        }
      }
    }
  }
}

注意：这么做会把所有子模块的错误提示都关掉，容易漏掉真正的问题，只建议临时用用。

3. 编译子模块为ARM模板再引用 #

要是没法改子模块代码，可以先把子模块编译成ARM模板（用bicep build dependencies/module.bicep命令），然后父模块直接引用编译后的.json文件：

module moduleWeDependOn 'dependencies/module.json' = if (param) {
  // 你的模块配置
}

Linter不会检查已编译的ARM模板，自然不会触发子模块里的规则错误。

为啥父模块的抑制注释没用？ #

Bicep的#disable-next-line只能管当前文件里的下一行代码，没法穿透到引用的子模块里。子模块的Linter错误是单独检查出来的，父模块的注释管不到子模块内部的规则违规。

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