Angular库发布为npm包后组件模块名被压缩混淆，如何配置解决？

安全阿岳

2026-10-4

问题根因

Angular 库编译工具 ng-packagr 会将未在公共API导出文件中显式声明为对外暴露的内容判定为内部实现，编译时会自动生成带ɵ前缀的混淆名称导出，避免外部直接引用内部代码。你当前生成的bundle索引第一行export * from './index';说明你的库根目录的入口导出文件（通常为src/index.ts或src/public-api.ts）未显式导出需要对外暴露的模块、组件、服务、管道，才会出现全部导出被混淆的问题。

解决步骤

第一步：修改库的公共导出文件
在库项目的src/index.ts（即你配置的入口文件）中，显式导出所有需要对外暴露的内容，示例如下：

// libs/core-ui/src/index.ts
export * from './lib/components/scrap-type-time-series-chart/scrap-type-time-series-chart.component';
export * from './lib/components/scrap-type-time-series-chart/scrap-type-time-series-chart.module';
export * from './lib/components/scrap-type-time-series-chart/scrap-type-time-series-chart.service';
export * from './lib/components/workplace-active-status-widget/workplace-active-status-widget.component';
export * from './lib/components/workplace-active-status-widget/workplace-active-status-widget.module';
export * from './lib/shared/pipes/date.pipe';
export * from './lib/shared/pipes/timer.pipe';
// 其余需要对外暴露的内容依次在此处添加导出

第二步：校验ng-packagr入口配置
检查库根目录的ng-package.json配置文件，确认lib.entryFile字段指向你刚才修改的公共导出文件：

{
  "lib": {
    "entryFile": "src/index.ts"
  }
}

第三步：可选优化编译配置
你当前tsconfig.lib.json中配置了enableIvy: false，Angular 12及以上版本官方推荐库使用部分编译模式，可将该配置替换为compilationMode: 'partial'，避免后续出现兼容性问题，修改后配置示例：

"angularCompilerOptions": {
    "skipTemplateCodegen": true,
    "strictMetadataEmit": true,
    "enableResourceInlining": true,
    "compilationMode": "partial"
}