NodeJS脚本动态导入含tsconfig路径别名模块的问题求助

针对你用ts.transpileModule转译TypeScript文件后，动态导入时因Node不识别tsconfig路径别名导致的"module not found"错误，这里提供几个实用的解决办法：

方案1：转译后手动替换路径别名 #

先读取项目根目录的tsconfig.json，解析其中的paths配置，然后在转译后的JS内容里把别名替换成对应的绝对路径。

示例代码修改：

// extract-messages.mjs
import * as fsp from 'node:fs/promises';
import ts from 'typescript';
import path from 'node:path';

// 读取并解析tsconfig
const tsconfigPath = path.resolve(process.cwd(), 'tsconfig.json');
const tsconfig = ts.readConfigFile(tsconfigPath, ts.sys.readFile).config;
const paths = tsconfig.compilerOptions.paths;

// 生成别名映射：key是别名前缀，value是对应的绝对路径
const aliasMap = {};
Object.entries(paths).forEach(([alias, [target]]) => {
  const aliasPrefix = alias.replace('/*', '');
  const targetPrefix = target.replace('/*', '');
  aliasMap[aliasPrefix] = path.resolve(process.cwd(), targetPrefix);
});

// 处理转译后的JS内容，替换别名
const tsContent = await fsp.readFile(targetAppRootMessageFile, { encoding: 'utf8' });
let jsContent = ts.transpileModule(tsContent, compilerOptions).outputText;

// 替换所有import语句里的别名
Object.entries(aliasMap).forEach(([alias, targetPath]) => {
  const regex = new RegExp(`('|")${alias}\\/`, 'g');
  jsContent = jsContent.replace(regex, `$1${targetPath}/`);
});

await fsp.writeFile(tempOutputFile, jsContent);

const { default: messages } = await import(tempOutputFile);
// ...后续转换与写入逻辑

方案2：用ts-node + tsconfig-paths让Node直接识别别名 #

不用手动替换路径，直接让Node在导入时解析tsconfig的路径别名，省去临时文件步骤。

先安装依赖：

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

修改脚本逻辑：

// extract-messages.mjs
import * as fsp from 'node:fs/promises';
import path from 'node:path';
import { register } from 'ts-node';
import { loadConfig } from 'tsconfig-paths';

// 注册ts-node和路径别名解析
const tsconfigPath = path.resolve(process.cwd(), 'tsconfig.json');
const { absoluteBaseUrl, paths } = loadConfig(tsconfigPath);

register({
  project: tsconfigPath,
  compilerOptions: {
    module: 'ESNext',
    target: 'ES2022'
  }
});

require('tsconfig-paths').register({
  baseUrl: absoluteBaseUrl,
  paths
});

// 直接导入原始的messages.ts文件（需用file://协议）
const messagesModule = await import(`file://${targetAppRootMessageFile}`);
const messages = messagesModule.default;

// ...后续转换与写入逻辑，无需生成临时文件

方案3：利用Nx原生能力处理 #

你的项目是Nx单仓，可直接复用Nx的编译与路径解析能力，比如自定义Nx Executor来完成消息提取任务，无需自己处理转译和路径问题。Nx会自动识别tsconfig中的路径别名，同时适配单仓多应用的场景。

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