Node.js + TypeScript 项目路径别名编译后未转换为相对路径导致模块找不到的问题求助

这个问题我之前也碰到过，核心原因是TypeScript的compilerOptions.paths只负责类型检查和编辑器智能提示，TS编译器（tsc）本身不会把别名替换成Node.js能识别的相对路径，所以编译后的JS文件里还保留着@App这类别名，Node自然找不到对应的模块。而Jest能正常工作是因为它自己的moduleNameMapper配置帮你映射了别名，和TS的路径配置是两套逻辑。

下面给你几个实用的解决方案，选一个适合你的场景：

方案一：用tsc-alias替换编译后的路径别名 #

这是最贴合你现有编译流程的方案，专门用来在tsc编译完成后，把JS文件里的别名替换成实际相对路径。

1. 安装依赖：

npm install --save-dev tsc-alias

2. 修改package.json的scripts配置：
   把原来的编译命令加上tsc-alias的执行，监听模式下也要同步开启别名替换的监听：

"scripts": {
  "build": "tsc --project tsconfig.build.json && tsc-alias -p tsconfig.build.json",
  "dev": "concurrently \"tsc -w --project tsconfig.build.json\" \"tsc-alias -w -p tsconfig.build.json\" \"nodemon dist/index.js\""
}

• tsc-alias -w：开启监听模式，TS文件更新编译后自动替换别名
• -p tsconfig.build.json：指定使用你的编译配置文件

方案二：用ts-node直接运行TS文件（无需提前编译） #

如果不想先编译成JS再运行，可以用ts-node直接执行TypeScript代码，同时加载路径别名配置，适合开发阶段快速迭代。

1. 安装依赖：

npm install --save-dev ts-node tsconfig-paths

2. 修改scripts配置：

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

如果需要文件变化后自动重启，换成ts-node-dev更方便：

npm install --save-dev ts-node-dev

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

方案三：用Babel配合插件处理编译 #

如果项目已经在用Babel，或者需要更灵活的编译配置，可以用babel-plugin-module-resolver来处理别名替换。

1. 安装依赖：

npm install --save-dev @babel/core @babel/preset-env @babel/preset-typescript babel-plugin-module-resolver

2. 创建babel.config.json：

{
  "presets": [
    "@babel/preset-env",
    "@babel/preset-typescript"
  ],
  "plugins": [
    [
      "module-resolver",
      {
        "root": ["./src"],
        "alias": {
          "@App": "./src"
        }
      }
    ]
  ]
}

3. 修改tsconfig.json，让TS只做类型检查（编译交给Babel）：
   在compilerOptions里添加：

"noEmit": true

4. 更新scripts配置：

"scripts": {
  "dev": "concurrently \"babel src --out-dir dist --extensions .ts --watch\" \"nodemon dist/index.js\""
}

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