如何修复Angular执行ng build lib构建自定义库时的模块识别报错

这个错误是ng-packagr构建Angular库时的典型外部依赖识别问题：你当前的库配置没有将angular-cesium标记为外部依赖，构建时ng-packagr会尝试扫描、打包该依赖的所有类型声明文件，把angular-cesium编译生成的ɵbo/ɵbp/ɵbx这类带混淆前缀的内部私有类，误判为你自己库中未声明模块归属的类，最终抛出错误。这些带ɵ前缀的类是第三方依赖内部实现用的，不需要在你自己的NgModule中声明。

• 第一步：补充库的peer依赖配置
  修改你自定义库目录下的package.json，把angular-cesium和它的前置依赖cesium加入peerDependencies，和宿主应用共用依赖实例，避免重复打包：

  {
    "name": "cesium-panorama-lib",
    "version": "0.0.1",
    "peerDependencies": {
      "@angular/common": "^8.2.14",
      "@angular/core": "^8.2.14",
      "angular-cesium": "和你项目中安装的版本保持一致",
      "cesium": "对应angular-cesium版本要求的兼容版本"
    }
  }
  

• 第二步：配置ng-packagr外部依赖白名单
  打开库目录下和package.json同层级的ng-package.json配置文件，添加whitelistedNonPeerDependencies配置（Angular 8对应的ng-packagr版本使用该配置项，高版本对应为allowedNonPeerDependencies），明确告知构建工具这些是外部依赖，不需要打包、扫描内部声明：

  {
    "$schema": "../../node_modules/ng-packagr/ng-package.schema.json",
    "dest": "../../dist/cesium-panorama-lib",
    "lib": {
      "entryFile": "src/public-api.ts"
    },
    "whitelistedNonPeerDependencies": [
      "angular-cesium",
      "cesium"
    ]
  }
  

• 第三步：校验库的TS编译配置
  打开库目录下的tsconfig.lib.json，确认include配置仅覆盖你自己库的源码路径，不要把node_modules目录加入编译范围；同时Angular 8版本下不要开启Ivy编译，保持默认的View Engine配置即可，避免和第三方依赖的编译产物冲突。
• 第四步：清理缓存后重新构建
  执行命令清理历史构建产物和缓存，避免旧缓存干扰构建结果：

  # Windows下可直接手动删除对应文件夹
  rm -rf dist
  rm -rf node_modules/.cache
  ng build my-lib
  

如果完成以上配置后仍报错，优先检查版本兼容性：

• Angular 8.2.14对应的兼容angular-cesium版本区间为0.0.58 ~ 0.0.62，如果你安装了适配Angular 9+的高版本angular-cesium，会因为依赖的编译格式和当前Angular版本的构建工具不兼容触发同类错误，降级到对应兼容版本即可。
• 检查库的源码，不要导入angular-cesium中带ɵ前缀的内部私有类，这类类不属于依赖对外暴露的API，导入后会被构建工具识别为未归属模块的非法声明。

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