Nx独立Angular项目@angular/core触发模块边界规则报错

问题根源 #

Nx的@nx/enforce-module-boundaries规则默认会校验所有导入语句，但Angular核心包属于第三方依赖，本就不在项目内部模块边界的管控范围内，所以规则误判了这些导入。

原生合规解决方案 #

别用allow通配符这种临时方案，直接用规则原生提供的allowedExternalImports配置项来指定允许的外部依赖：

在项目根目录的.eslintrc.json（或对应子项目的ESLint配置文件）里，找到@nx/enforce-module-boundaries的规则配置，添加allowedExternalImports字段：

{
  "rules": {
    "@nx/enforce-module-boundaries": [
      "error",
      {
        "enforceBuildableLibDependency": true,
        "allow": [],
        "depConstraints": [
          {
            "sourceTag": "scope:main",
            "onlyDependOnLibsWithTags": ["scope:my-components"]
          },
          {
            "sourceTag": "scope:my-components",
            "onlyDependOnLibsWithTags": []
          }
        ],
        // 列出需要允许的Angular核心包
        "allowedExternalImports": ["@angular/core", "@angular/common", "@angular/forms", "@angular/router"]
      }
    ]
  }
}

如果想一次性放行所有Angular官方包，用精准的通配符即可：

"allowedExternalImports": ["@angular/*"]

为什么这是合理方案？ #

allowedExternalImports是Nx为这个规则专门设计的配置，就是用来排除第三方npm包的边界校验，完全贴合规则的设计逻辑。相比用allow字段（原本是给项目内部模块开例外的），这个配置更语义化，也不会影响项目内部模块的边界管控效果。

进阶优化 #

如果项目里有多个Angular应用和库，可以把这个配置抽离到Nx的自定义ESLint预设中（比如tools/eslint-configs下的共享配置），避免每个项目重复写相同配置。

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