Angular 16中TS2307错误：无法识别自定义库模块

1. 检查自定义库的package.json配置 #

这是最可能的问题根源，必须确保库的package.json里的main、module、types字段指向编译后的产物文件，而非源码路径。示例配置如下：

{
  "name": "demo002-library",
  "main": "./bundles/demo002-library.umd.js",
  "module": "./fesm2020/demo002-library.mjs",
  "types": "./index.d.ts",
  // 其他配置项...
}

这些路径要和Angular CLI构建库后生成的文件结构完全匹配，发布时务必保证这些编译产物都被包含在包内。

2. 确认库的编译产物完整 #

重新构建库时，执行ng build demo002-library（如果是Angular工作区中的库），构建完成后检查dist/demo002-library目录，确认存在index.d.ts、UMD包、FESM包这些核心文件，缺失任何一个都会导致TypeScript解析失败。

3. 配置主项目的tsconfig.json路径映射 #

如果你的库是本地开发、尚未发布到npm的状态，需要在主项目的tsconfig.json中添加路径映射，让TypeScript能找到库的编译产物：

{
  "compilerOptions": {
    "paths": {
      "demo002-library": ["../demo002-library/dist/demo002-library"]
    }
  }
}

如果库已经发布到npm，这一步可以跳过；但如果是用npm link本地关联的包，要确保link的是库的dist目录，而非源码目录。

4. 清除缓存并重启IDE #

• 执行ng cache clean清除Angular缓存
• 删除node_modules/.cache目录清除Node模块缓存
• 重启你的IDE（比如VS Code），IDE有时会缓存旧的类型信息，导致无法识别更新后的包配置

5. 核对依赖版本兼容性 #

确保主项目的Angular版本和自定义库的Angular版本完全兼容，Angular 16的库建议用Angular 16构建，版本不匹配也可能引发解析问题。

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