TypeScript别名导入为何在同目录部分文件生效部分失效？

数据老陈

2026-6-25

解决TypeScript别名导入部分文件失效的问题

问题根源

TypeScript自带的tsc编译器仅做类型检查，不会自动替换paths配置里的自定义别名。你看到Entity.js正常是偶然情况（比如编辑器自动转换、手动修改过文件），而Fusion.js保留了别名后，Node.js无法识别这类自定义别名，因此报错。

具体解决方法

方案1：运行时让Node识别别名（简单快捷）

安装依赖：
```
npm install tsconfig-paths --save-dev
```
修改运行命令，通过tsconfig-paths/register加载别名配置：
把原来的node dist/index.js改成：
```
node -r tsconfig-paths/register dist/index.js
```
如果用npm脚本，在package.json里更新：
```
"scripts": {
  "build": "rimraf ./dist && tsc",
  "start": "node -r tsconfig-paths/register dist/index.js"
}
```

方案2：编译时替换别名（生成可直接运行的JS）

安装依赖：
```
npm install tsc-alias --save-dev
```
修改构建命令，在tsc编译后执行别名替换：
```
"scripts": {
  "build": "rimraf ./dist && tsc && tsc-alias"
}
```
这样编译后的所有JS文件里的别名都会被替换成相对路径，直接用node dist/index.js就能运行，不需要额外运行时依赖。

必做配置检查

确保你的tsconfig.json配置正确，以下核心字段不能少：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@enums/*": ["src/enums/*"]
    },
    "outDir": "./dist",
    "rootDir": "./src" // 保证编译后目录结构与源码一致
  },
  "include": ["src/**/*"] // 确保所有TS文件都被纳入编译范围
}