Angular 2+导入自定义包报错：无法找到模块@customPackage/forms求助

遇到这种找不到模块的报错，通常是TypeScript或Angular的模块解析机制没正确识别到你放在node_modules里的自定义包，下面是一步步的排查和解决方法：

• 检查自定义包的package.json配置
  首先要确保node_modules/@customPackage/forms目录下有一个合法的package.json文件，里面必须明确指定模块的入口和类型定义（如果是TS包）。比如：

  {
    "name": "@customPackage/forms",
    "version": "1.0.0",
    "main": "./dist/index.js", // 编译后的JS入口文件路径
    "types": "./dist/index.d.ts" // TypeScript类型定义文件路径
  }
  

  如果你的包还没编译成JS（直接放的TS源码），要么先编译，要么确保入口指向.ts文件，但更推荐先编译成JS产物。

• 配置TypeScript路径映射
  打开项目根目录的tsconfig.json，在compilerOptions中添加paths配置，明确告诉TypeScript这个模块的位置：

  {
    "compilerOptions": {
      // 其他已有的配置...
      "paths": {
        "@customPackage/forms": ["node_modules/@customPackage/forms"]
      }
    }
  }
  

  对于Angular CLI项目，这个配置会被自动识别，但有时候需要重启构建服务才能生效。

• 重启开发服务和IDE
  TypeScript和IDE（比如VS Code）都会缓存模块解析信息，所以先停止当前的ng serve命令，重新启动它，同时重启你的IDE，让它重新加载配置和模块信息。

• 验证文件结构与导出
  确认@customPackage/forms的入口文件（比如index.js或index.ts）中确实导出了blabla，比如：

  // node_modules/@customPackage/forms/index.ts
  export const blabla = /* 你的模块内容 */;
  

  如果入口文件路径不对，或者没导出目标内容，也会导致找不到的错误。

• 手动声明模块（无类型定义时）
  如果你的自定义包没有提供TypeScript类型定义文件，可以在项目的src/typings.d.ts中手动声明这个模块：

  declare module '@customPackage/forms' {
    export const blabla: /* 替换成实际的类型，比如string/function等 */;
  }
  

  这样TypeScript就不会再报找不到模块的错误了。

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