如何结合TypeScript路径别名使用Node.js文件系统功能？

TypeScript的paths别名只是编译时的语法糖，Node.js运行时根本不识别这些别名——你直接用@app/specialLib/item-log.json作为文件路径时，Node会把它当成项目根目录下的字面量路径去查找，自然找不到对应文件。

要解决这个问题，核心思路是把别名转换成Node能识别的真实文件路径，下面是几种实用方案：

方案一：手动替换别名（简单直接） #

既然你明确知道@app/specialLib对应的真实路径是libs/specialLib/src，可以写一个简单函数做路径替换，结合项目根目录生成真实路径：

import { resolve } from 'path';
import { writeFileSync } from 'fs';

// 解析别名到真实文件路径
function getRealPath(aliasPath: string): string {
  // process.cwd()返回当前脚本运行的项目根目录
  const rootDir = process.cwd();
  // 替换别名前缀为真实路径
  return aliasPath.replace('@app/specialLib', resolve(rootDir, 'libs/specialLib/src'));
}

// 使用示例
const itemLog = getRealPath('@app/specialLib/item-log.json');

// 读取并修改日志内容
let loggedItems: LogItem[] = require(itemLog);
loggedItems = loggedItems.filter(({ id }) => id !== this.id);

// 写入修改后的内容
writeFileSync(itemLog, JSON.stringify(loggedItems));

方案二：自动读取tsconfig配置（灵活适配） #

如果怕后续paths配置变更导致手动替换失效，可以读取tsconfig.json里的别名映射，动态解析路径：

import { resolve, parse } from 'path';
import { writeFileSync, readFileSync } from 'fs';

// 从tsconfig解析别名并转换为真实路径
function resolveTsAlias(aliasPath: string): string {
  // 读取项目根目录下的tsconfig.json
  const tsconfigPath = resolve(process.cwd(), 'tsconfig.json');
  const tsconfigContent = readFileSync(tsconfigPath, 'utf-8');
  const { compilerOptions: { paths } } = JSON.parse(tsconfigContent);

  // 遍历所有别名规则，匹配并替换
  for (const [aliasPattern, [targetPath]] of Object.entries(paths)) {
    // 处理带通配符*的别名（比如@app/specialLib/*）
    const regex = new RegExp(`^${aliasPattern.replace('*', '(.*)')}$`);
    const match = aliasPath.match(regex);
    
    if (match) {
      // 替换通配符部分，生成真实路径
      const realTarget = targetPath.replace('*', match[1]);
      return resolve(parse(tsconfigPath).dir, realTarget);
    }

    // 处理不带通配符的别名
    if (aliasPath === aliasPattern) {
      return resolve(parse(tsconfigPath).dir, targetPath);
    }
  }

  // 未匹配到别名时返回原路径
  return aliasPath;
}

// 使用示例
const itemLog = resolveTsAlias('@app/specialLib/item-log.json');
// 后续读写逻辑和之前一致

注意事项 #

• 如果运行编译后的JS文件，确保process.cwd()指向项目根目录（不要从子目录直接运行编译后的文件），否则路径会出错。
• 如果你用ts-node直接运行TS脚本，可配合tsconfig-paths模块让Node识别别名，但文件系统操作依然需要真实路径——require能通过模块解析器识别别名，但fs的方法直接使用别名还是会报错，最终还是要转成真实路径。

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