TypeScript如何从rootDir与baseUrl外的目录导入模块？

核心问题分析 #

• include范围不足：当前仅包含backend/src下的文件，TypeScript不会扫描外部的utils目录，导致无法识别模块和类型声明。
• paths映射路径错误：baseUrl已指向monorepo根目录（../），paths里的../utils/*会被解析为../../utils/*，路径层级错误。

修复步骤 #

1. 调整backend的tsconfig.json #

更新配置让TypeScript识别utils目录，并修正路径映射：

{
  "include": [
    "src/**/*.ts",
    "../utils/**/*.ts",
    "../utils/**/*.d.ts"
  ],
  "exclude": [
    "node_modules",
    ".vscode",
    "../utils/**/*.spec.ts" // 可选：排除测试文件
  ],
  "compilerOptions": {
    /* 保留原有其他配置 */
    "target": "ES2022",
    "lib": ["ES2022"],
    "module": "commonjs",
    "rootDir": "./src",
    "moduleResolution": "node",
    "baseUrl": "../",
    "paths": {
      "utils/*": ["utils/*"] // 修正路径映射，基于baseUrl直接指向utils目录
    },
    "rootDirs": ["./src", "../utils"], // 声明两个目录为源码根目录，辅助类型检查
    "resolveJsonModule": true,
    "sourceMap": true,
    "outDir": "./dist",
    "removeComments": true,
    "noEmitOnError": true,
    "esModuleInterop": true,
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "skipLibCheck": true
  }
}

2. 优化utils目录的TypeScript配置（可选） #

在utils目录下创建独立的tsconfig.json，统一编译规则并自动生成类型声明：

{
  "compilerOptions": {
    "target": "ES2022",
    "module": "ESNext",
    "strict": true,
    "declaration": true, // 自动生成.d.ts文件
    "outDir": "./dist",
    "esModuleInterop": true,
    "skipLibCheck": true
  },
  "include": ["**/*.ts"],
  "exclude": ["node_modules", "dist"]
}

3. 解决运行时模块查找问题 #

TypeScript的paths仅用于编译时类型检查，运行时需要确保Node.js能找到utils模块：

• 使用ts-node运行：安装tsconfig-paths，修改backend的package.json启动脚本：

  "scripts": {
    "start": "ts-node -r tsconfig-paths/register src/index.ts"
  }
  

• 编译后运行：编译后将utils目录复制到backend/dist，或者设置NODE_PATH：

  # 编译时复制utils
  tsc && cp -r ../utils dist/utils
  # 运行时指定根目录
  NODE_PATH=../ node dist/index.js
  

验证导入 #

修改完成后，即可在backend源码中正常导入：

import { Validator } from 'utils/Validator';

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