自定义Angular库集成Moment.js发布NPM后出现类型错误求助

以下是导致该类型错误的核心原因：

• TypeScript版本差异引发的类型解析冲突
  你的Angular库基于13.3.10（对应TypeScript 4.6.x）构建，而主项目使用13.5.0（对应TypeScript 4.7.x）。尽管Moment.js版本一致，但不同TS版本对模块类型的解析逻辑存在细微差异——比如对UMD模块的类型推断、默认导出的处理方式不同，导致主项目加载库的类型定义时出现不兼容。

• 库打包时的类型依赖处理不当
  Angular库发布时，若tsconfig.lib.json配置存在问题会触发冲突：

  • 未启用skipLibCheck: true，导致打包过程重复检查Moment的类型定义，生成的.d.ts文件包含冗余声明；
  • compilerOptions中的typeRoots或paths配置错误，使得库的类型定义直接嵌入Moment的类型，而非引用主项目的依赖类型，进而和主项目的Moment类型产生冲突。

• 模块导入的类型推断环境差异
  本地测试时，库和主项目共享同一node_modules环境，TypeScript能统一解析Moment的模块类型。但发布后，库的类型定义里的导入方式（比如import * as moment_ from 'moment'）在主项目的TS版本下，可能被推断为与主项目直接导入的Moment类型不匹配的结构，触发类型错误。

• 重复类型定义的加载
  若库的package.json未将moment设为peerDependency，而是设为dependency，会导致主项目同时加载库自带的Moment类型和主项目自身的Moment类型——两个相同但独立的类型定义会被TS视为不同类型，引发冲突。

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