Angular 12类库构建报错：moduleName.startsWith is not a function求排查方案

从你的package.json定位核心嫌疑点 #

你的项目依赖中@types/node版本为^20.2.5，但Angular 12官方明确要求Node.js版本为12.20.x、14.15.x或16.x。高版本Node.js（尤其是20.x）与Angular 12的工具链（比如你用的ng-packagr@12.2.7）存在兼容性冲突，很大概率导致构建过程中某个内部变量moduleName被处理成非字符串类型，从而触发startsWith is not a function报错。

获取更多调试信息的实用方法 #

1. 直接调用ng-packagr并开启调试 #

类库构建本质由ng-packagr执行，绕过Angular CLI直接调用它并添加--debug参数，能输出完整的错误堆栈，精准定位报错代码位置：

ng-packagr -p projects/our-pkg-lib/ng-package.json --debug

2. 切换兼容的Node.js版本 #

用nvm或n等版本管理工具切换到Angular 12支持的Node.js版本（比如14.21.3 LTS）：

# 以nvm为例
nvm install 14.21.3
nvm use 14.21.3

切换后清理旧依赖并重新安装：

rm -rf node_modules package-lock.json
npm install

3. 清理Angular CLI缓存 #

缓存异常也可能引发奇怪问题，执行命令彻底清理：

ng cache clean --all

4. 逐步排查依赖冲突 #

• 临时注释package.json中的内部依赖@our-org/another-internal-pkg，重新构建，确认是否是该内部包导致的问题。
• 暂时移除非核心第三方依赖（比如ngx-mask、ngx-trumbowyg），逐个恢复并重新构建，定位冲突依赖。

验证修复 #

完成上述操作后，先执行基础构建命令测试：

ng build our-pkg-lib

如果构建成功，再逐步恢复之前移除的依赖和脚本。

内容的提问来源于stack exchange，提问作者GS-Scooter