NestJS CLI创建的库无法导入：找不到@app/big-query模块

检查TypeScript路径配置 #

• 确认根目录tsconfig.json（或monorepo结构的tsconfig.base.json）中，compilerOptions.paths已正确映射库的别名：

  {
    "compilerOptions": {
      "paths": {
        "@app/big-query": ["./libs/big-query/src"],
        "@app/big-query/*": ["./libs/big-query/src/*"]
      }
    }
  }
  

• 子项目的tsconfig.json需要通过"extends": "../tsconfig.base.json"继承基础配置，保证路径映射全局生效。

验证库的构建产物 #

• 查看libs/big-query/dist目录是否存在，且包含编译后的.js、.d.ts等文件。
• 若构建不完整，重新执行构建命令：nest build big-query，确保过程无报错输出。

核对库的package.json配置 #

• 打开libs/big-query/package.json，确认以下核心字段配置正确：

  {
    "name": "@app/big-query",
    "main": "./dist/index.js",
    "typings": "./dist/index.d.ts"
  }
  

  字段值需与导入的别名完全一致，且指向正确的构建产物路径。

清理缓存并重启开发环境 #

• 删除根目录的.tsbuildinfo文件，或执行npx tsc --clean清除TypeScript缓存。
• 重启IDE（如VS Code），避免IDE缓存导致模块识别延迟。

检查导入语句准确性 #

• 确保导入路径与配置的别名完全匹配，无拼写、大小写或符号错误，示例：

  import { BigQueryModule } from '@app/big-query';
  

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