为什么AngularWebpackPlugin将我的Angular库编译为CommonJS格式？

这个问题核心是Angular工具链的模块格式判断逻辑受依赖版本、库package.json入口字段优先级共同影响，和你业务侧的tsconfig没有直接关联，常见触发原因如下：

• 你发布的库新版本在调整依赖时，间接升级了ng-packagr/@angular/compiler-cli等库打包工具的版本，这类工具的小版本迭代可能修改默认产物输出规则：比如部分版本的ng-packagr默认关闭UMD产物输出，或者修改了package.json入口字段的生成逻辑，丢失了module/es2020等ES模块入口，仅保留了commonjs格式的main入口。
• 库的package.json被意外新增了"type": "commonjs"配置，Webpack 5解析该字段时会强制将该包识别为commonjs模块，优先级高于你本地的tsconfig配置。
• 上层应用的@angular-devkit/build-angular/AngularWebpackPlugin依赖版本发生了变化，Angular Linker（负责编译第三方Angular库的组件）的默认模块格式匹配规则迭代，当识别到库的入口为commonjs格式时，会直接输出commonjs编译产物。

按优先级逐一排查配置即可：

1. 修正库的package.json入口配置
   确认你发布的npm库的package.json中包含明确的ES模块和UMD入口配置，示例如下：

   {
     "main": "./bundles/my-library.umd.js",
     "module": "./fesm2020/my-library.js",
     "es2020": "./fesm2020/my-library.js",
     "typings": "./index.d.ts"
   }
   

   如果你用ng-packagr打包库，需要在ng-package.json中显式开启UMD输出，配置umd模块映射：

   {
     "lib": {
       "entryFile": "src/public-api.ts",
       "umdModuleIds": {
         "@angular/core": "ng.core",
         "@angular/common": "ng.common"
       }
     }
   }
   

2. 显式配置Webpack入口解析优先级
   在上层应用的Webpack配置中新增resolve.mainFields配置，强制优先读取ES模块入口，避免默认匹配到commonjs入口：

   module: {
     resolve: {
       mainFields: ['module', 'browser', 'main']
     },
     // 原有配置保持不变
     rules: [...],
     output: {
       libraryTarget: 'umd'
     },
     plugins: [
       new AngularWebpackPlugin({
         tsconfig: './path/to/tsconfig'
       })
     ],
     target: ['es5']
   };
   

3. 强制Angular Linker输出格式
   在消费端的tsconfig.json中新增angularCompilerOptions配置，明确编译模式：

   {
     "compilerOptions": {
       // 原有配置保持不变
       "module": "es2020",
       "target": "es5",
       "types": ["node"],
       "lib": ["dom", "es2019"]
     },
     "angularCompilerOptions": {
       "enableIvy": true,
       "compilationMode": "partial"
     }
   }
   

依赖版本变化确实会直接影响模块定义：Angular的编译链路（ng-packagr、compiler-cli、AngularWebpackPlugin）属于工具链依赖，这类包的版本迭代经常会调整默认编译规则、产物输出逻辑、入口字段解析优先级，即使你没有修改任何自定义配置，工具链的默认规则变更也会直接改变最终的模块输出格式。

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