在NX项目中如何从一个库导入另一个库？

一、确保库的创建符合NX规范 #

两个库必须通过NX官方命令创建，才能让NX自动管理依赖映射与路径配置：

• 创建utils-logger库：

  nx g @nx/js:library utils-logger --importPath=@nx-app/utils-logger
  

• 创建utils-logger-transports库：

  nx g @nx/js:library utils-logger-transports --importPath=@nx-app/utils-logger-transports
  

--importPath参数会自动同步到库的package.json的name字段，以及tsconfig.base.json的paths配置，避免手动配置出错。

二、解决"找不到模块"的问题 #

1. 验证核心配置 #

• 检查tsconfig.base.json的paths节点，确保两个库的路径映射正确：

  "paths": {
    "@nx-app/utils-logger": ["libs/utils-logger/src/index.ts"],
    "@nx-app/utils-logger-transports": ["libs/utils-logger-transports/src/index.ts"]
  }
  

• 确认每个库的package.json中name字段与导入路径完全一致，比如utils-logger-transports的package.json应包含：

  "name": "@nx-app/utils-logger-transports"
  

2. 处理构建与缓存问题 #

• 先构建被依赖的utils-logger-transports库：

  nx build utils-logger-transports
  

  NX的库默认需要构建后才能被其他项目/库引用，未构建时易出现模块找不到的错误。
• 清除NX缓存，解决可能的缓存冲突：

  npx nx reset
  

• 重启TypeScript语言服务（比如VS Code中按Ctrl+Shift+P，选择"TypeScript: Restart TS Server"）。

3. 验证NX项目配置 #

检查nx.json的projects节点，确保两个库都被NX正确识别，示例：

"projects": {
  "utils-logger": "libs/utils-logger",
  "utils-logger-transports": "libs/utils-logger-transports",
  // 其他项目...
}

三、库之间相互导入的正确流程 #

1. 在utils-logger的代码中直接使用命名空间导入：

   import { SomeTransport } from '@nx-app/utils-logger-transports';
   
   // 使用导入的模块
   export const logger = new Logger({
     transports: [new SomeTransport()]
   });
   

2. 开发时使用watch模式自动同步依赖：

   nx watch --projects=utils-logger-transports,utils-logger --target=build
   

   这样当utils-logger-transports修改时，会自动重新构建，utils-logger能实时获取更新。
3. 类型检查与验证：
   运行类型检查确保无错误：

   nx run-many --target=type-check --projects=utils-logger,utils-logger-transports
   

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