Express+TypeScript中@src路径别名解析失败，如何正确配置？

1. 修正tsconfig.json的路径配置 #

你的tsconfig.json里baseUrl已设为./src，但paths配置存在冗余层级，导致路径映射错误。正确配置如下：

{
  "compilerOptions": {
    "baseUrl": "./src",
    "paths": {
      "@src/*": ["*"] // baseUrl已指向src目录，此处直接映射到该目录下的所有文件
    },
    // 保留你的其他必要配置（如target、module、outDir等）
  },
  "include": ["src/**/*"],
  "exclude": ["node_modules"]
}

解释：当baseUrl为./src时，@src/student/student.interface会被正确解析为src/student/student.interface，与你期望的路径匹配。

2. 刷新编辑器TypeScript服务 #

VS Code等编辑器可能缓存旧配置，导致修改后不立即生效。可以按下Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入TypeScript: Restart TS Server重启服务，或直接重启编辑器。

3. 处理ts-node运行时的路径解析 #

如果用ts-node直接运行项目，TypeScript的paths配置不会被运行时自动解析，需安装tsconfig-paths：

npm install tsconfig-paths --save-dev

之后通过以下命令启动项目：

ts-node -r tsconfig-paths/register src/index.ts

也可以在package.json的scripts中配置快捷启动命令：

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

4. Webpack打包工具的别名配置（若使用） #

如果用Webpack打包项目，需在webpack.config.js中添加对应别名配置，与TypeScript的路径别名保持一致：

const path = require('path');

module.exports = {
  // 其他Webpack配置
  resolve: {
    alias: {
      '@src': path.resolve(__dirname, 'src/')
    },
    extensions: ['.ts', '.js']
  }
};

验证配置 #

修改完成后，重新尝试导入语句：

import { Guardian, LocalGuardian, Student, UserName } from '@src/student/student.interface';

此时模块应能正常解析。

内容的提问来源于stack exchange，提问作者Emdadudl Haque Apu