Node.js中使用tsc-watch时配置TypeScript路径别名无效的问题排查与方案咨询

看起来你在ES模块模式下配置TS路径别名时踩了不少坑，这类问题确实因为CommonJS和ES模块的差异容易出问题，我来帮你一步步梳理排查，给出可行的解决思路：

一、先修正现有配置里的几个明显问题 #

1. tsconfig.json里的@generated路径错误
   你当前配置的"@generated/*": ["/generated/*"]是系统绝对路径，会指向根目录下的generated文件夹，而非项目内的目录，应该改成相对路径：

   "@generated/*": ["./generated/*"]
   

   同时记得把generated目录加入include数组，确保TS能编译该目录下的文件：

   "include": ["src", "generated"]
   

2. 注意文件夹拼写一致性
   你配置里写的是@controlers/*，如果实际文件夹名是controllers（常见拼写），这里的拼写错误会导致别名映射失效，要确保路径和实际文件夹名完全一致。
3. module-aliases的兼容性问题
   _moduleAliases是module-alias包的配置，这个包默认只支持CommonJS模块，而你的项目是ES模块（"type": "module"），所以这个配置大概率不会生效，可以先注释掉，换用ES模块兼容的方案。

二、编译后运行（tsc-watch）的修复方案 #

因为你用了module: nodenext（ES模块模式），tsconfig-paths/register的require钩子对ES模块不起作用，需要用专门的ES模块loader来处理别名：

步骤1：安装适配ES模块的路径别名loader #

npm install tsconfig-paths-esm-loader --save-dev

步骤2：修改package.json的dev脚本 #

把原来的启动命令替换为使用该loader的版本：

"scripts": {
  "dev": "tsc-watch --onSuccess \"node --loader tsconfig-paths-esm-loader ./dist/index.js\"",
  "test": "echo \"Error: no test specified\" && exit 1"
}

这个loader会自动读取tsconfig.json里的paths映射，在Node运行时把别名替换为正确的相对路径。

三、直接运行TS文件（实时热重载，无需预编译）的方案 #

如果你想跳过编译步骤，直接实时运行TS文件，可以用nodemon + ts-node + 适配ES模块的别名处理：

步骤1：修改nodemon.json配置 #

更新你的nodemon配置为：

{
  "watch": ["src", "generated"],
  "ext": "ts,json",
  "exec": "node --loader ts-node/esm --loader tsconfig-paths-esm-loader ./src/index.ts"
}

步骤2：更新package.json的dev脚本 #

改成直接启动nodemon：

"scripts": {
  "dev": "nodemon",
  "test": "echo \"Error: no test specified\" && exit 1"
}

额外提醒：ES模块模式下的import后缀 #

你在TS文件里写的import authRoutes from "@routes/auth_routes.js";是正确的——ES模块模式下必须显式添加.js后缀，TS会在编译或运行时自动映射到对应的TS/JS文件，不用修改这个写法。

四、验证配置的小技巧 #

不管用哪种方案，都可以先做简单验证：

• 手动执行一次tsc编译，检查dist目录下的文件中，import路径是否被正确替换
• 启动dev脚本后，观察控制台是否还有"找不到模块"的错误
• 如果还是有问题，可以尝试删除node_modules和package-lock.json，重新执行npm install后再测试

内容来源于stack exchange