TypeScript Express/Node服务导入绝对路径配置失效问题咨询

问题根因定位 #

当前配置无法生效的核心原因有三点：

• 路径映射规则配置矛盾：设置baseUrl为./src后，仍将paths的匹配规则设为./src/*，实际会偏移匹配到不存在的src/src层级目录
• 缺失运行时解析能力：TypeScript的paths配置仅作用于编译阶段的类型检查，编译生成的CommonJS模块代码不会自动转换路径，Node运行时无法识别自定义路径规则
• 类型声明配置错误：typeRoots字段仅用于存放类型包的根目录，将单文件@types/custom.d.ts加入该字段不符合配置规范

分步配置指引 #

1. 修正tsconfig.json #

替换原有错误配置，匹配项目目录结构：

{
  "compilerOptions": {
    "target": "es5",
    "module": "commonjs",
    "outDir": "./dist",
    "strict": true,
    "baseUrl": "./src",
    "paths": {
      "*": ["*"]
    },
    "typeRoots": ["./@types"],
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true
  },
  "include": [
    "@types/**/*.d.ts",
    "src/**/*"
  ],
  "exclude": ["node_modules"]
}

配置完成后，源码内可直接以src目录为根做绝对路径导入，例如导入src/utils/request.ts时，无需写相对路径../../utils/request，直接写utils/request即可被TypeScript正确识别类型。

2. 配置运行时路径解析 #

安装tsconfig-paths依赖，用于让Node运行时识别tsconfig中定义的路径规则：

• 安装命令：npm install tsconfig-paths --save
• 启动逻辑改造：在服务启动时注册路径解析能力
  • 开发态（直接运行TypeScript源码）：搭配ts-node使用，启动命令为ts-node -r tsconfig-paths/register src/index.ts
  • 生产态（运行dist目录下的编译产物）：启动命令为node -r tsconfig-paths/register dist/index.js

3. 固定启动脚本 #

在package.json中预设常用命令，减少重复输入：

{
  "scripts": {
    "dev": "ts-node -r tsconfig-paths/register src/index.ts",
    "build": "tsc",
    "start": "node -r tsconfig-paths/register dist/index.js"
  }
}

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