为何自定义TypeScript别名在MERN项目后端无法生效？

你的问题核心在于：TypeScript的paths配置仅对TS编译器生效，但Node.js运行时（包括ts-node-dev）本身不支持解析这些自定义别名，需要额外工具桥接，同时你的tsconfig还缺少关键的baseUrl配置。

步骤1：补充tsconfig.json的baseUrl配置 #

paths依赖baseUrl来解析路径基准，必须在compilerOptions中添加该配置，否则TS无法正确定位别名对应的文件：

{
  "compilerOptions": {
    "target": "es2018",
    "module": "commonjs",
    "strict": true,
    "esModuleInterop": true,
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true,
    "moduleResolution": "node",
    "resolveJsonModule": true,
    "outDir": "dist",
    "baseUrl": ".", // 新增：将基准路径设为项目根目录
    "paths": {
      "@controllers/*": ["./src/controllers/*"],
      "@models/*": ["./src/models/*"],
      "@routes/*": ["./src/routes/*"],
      "@customTypes/*": ["./src/customTypes/*"],
      "@databases/*": ["./src/databases/*"],
      "@functions/*": ["./src/functions/*"],
      "@middlewares/*": ["./src/middlewares/*"]
    }
  },
  "exclude": ["node_modules"]
}

步骤2：安装tsconfig-paths依赖 #

这个包能让Node.js识别TS配置中的paths别名：

npm install tsconfig-paths --save-dev

步骤3：修改package.json的启动脚本 #

在ts-node-dev启动命令中添加-r tsconfig-paths/register参数，让运行时加载别名解析器：

假设原启动脚本为：

"scripts": {
  "dev": "ts-node-dev src/index.ts"
}

修改为：

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

步骤4：验证文件路径正确性 #

确保@routes/login对应文件存在：

• 检查是否有src/routes/login.ts文件
• 若为目录结构，需存在src/routes/login/index.ts（此时可直接用@routes/login导入）

完成以上步骤后重启开发服务器，自定义别名即可被正确识别。

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