如何配置@resources路径别名实现TypeScript短路径导入？

问题分析 #

短路径导入失效的核心原因有两点：

1. paths配置未使用通配符匹配子路径，仅能匹配@resources本身，无法解析@resources/entity这类带层级的导入
2. 复合项目缺少必要的模块解析规则和类型声明生成配置

具体修复步骤 #

1. 更新/server/tsconfig.json配置

调整moduleResolution和paths字段，确保路径映射覆盖所有子路径：

{
  "compilerOptions": {
    "target": "es5",
    "module": "commonjs",
    "declaration": true,
    "declarationMap": true,
    "outDir": "dist",
    "strict": true,
    "moduleResolution": "node", // 开启Node模块解析策略，paths依赖此规则生效
    "baseUrl": ".",
    "paths": {
       "@resources/*": ["../model/src/resources/*"] // 添加通配符*，匹配所有子路径层级
     },
    "skipLibCheck": true,
    "forceConsistentCasingInFileNames": true    
 },
 "include": ["src/**/*"],
 "references": [{
   "path": "../model/"
 }]
}

2. 更新/model/tsconfig.json配置

开启声明文件生成并明确包含源码目录，确保复合项目引用时能找到类型定义：

{
  "compilerOptions": {
    "composite": true,
    "target": "es2016",
    "module": "commonjs",
    "outDir": "dist",
    "declaration": true, // 生成类型声明文件，供server项目引用
    "declarationMap": true,
    "esModuleInterop": true, 
    "forceConsistentCasingInFileNames": true,
    "strict": true,
    "skipLibCheck": true
  },
  "include": ["src/**/*"], // 确保src下所有文件被编译
  "exclude": ["node_modules", "dist"]
}

3. 重新编译项目

在/server目录下执行：

tsc -b

验证修复 #

修改app.ts中的导入语句为短路径形式：

import IEntity from '@resources/entity/entity.interface';

此时编译应正常通过，路径别名生效。

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