Angular 9构建@scope/xxx库报Custom named exports错误如何解决
Angular 9 带作用域库构建CommonJS导出格式错配报错修复方案
报错触发核心原因
该报错来自Angular官方库构建工具ng-packagr的格式校验逻辑:构建流程检测到配置中存在仅适用于CommonJS/UMD产物的自定义命名导出规则,但实际生成的fesm5/fesm2015文件是标准ES模块格式,两者不匹配直接触发构建中断。
分步修复操作
- 第一步:清理ng-package.json的历史残留配置
打开库项目目录下的ng-package.json配置文件,移除两类冗余配置:- 移除所有手写的
umdModuleIds、customExports字段,这类字段是Angular 8及更早版本专门用于给UMD产物映射全局变量的配置,Angular 9构建流程不会为fesm文件生成CommonJS格式的导出绑定,残留配置是该报错的最常见诱因 - 不要手动修改配置里的输出格式选项,保持和Angular CLI自动生成的模板一致,仅保留业务需要的
entryPoint、styleIncludePaths等必要字段
- 移除所有手写的
- 第二步:统一入口文件的导出语法规范
打开库的入口文件public-api.ts,排查混用的CommonJS语法:- 所有导出逻辑必须统一使用ES模块语法,禁止出现
module.exports、exports.xxx = xxx这类CommonJS写法 - 检查是否存在手动包裹第三方CommonJSJS依赖、为其指定自定义命名导出的逻辑,这类逻辑会被构建工具判定为需要输出CommonJS格式命名导出,和实际生成的ES模块产物产生格式冲突
- 所有导出逻辑必须统一使用ES模块语法,禁止出现
- 第三步:对齐构建依赖的版本匹配关系
检查项目中ng-packagr的版本是否和Angular 9大版本兼容:- Angular 9.x 对应的兼容ng-packagr版本范围是9.0.0 ~ 9.2.x,版本错配会导致构建管线的校验规则和实际输出产物不匹配
- 执行
npm ls ng-packagr查看当前安装版本,存在版本冲突时,通过npm install ng-packagr@^9.2.0 --save-dev对齐适配版本
- 第四步:校验TypeScript编译配置
打开库对应的tsconfig.lib.json文件,确认compilerOptions.module的值设置为es2015,不要手动修改为commonjs——否则TS编译输出的文件格式会和ng-packagr预期的ES模块标准不匹配,同样会触发该报错 - 第五步:清理缓存重新构建
移除旧的产物和缓存文件:删除项目根目录下的dist/文件夹、库项目目录下的.ng/缓存、node_modules/.cache/目录,重新执行ng b @scope/xxx触发干净的构建流程
内容的提问来源于stack exchange,提问作者AminRostami
相关产品推荐
相关产品推荐

