Node.js项目迁移TypeScript时JS导入TS文件报找不到模块错误

核心问题原因 #

你遇到的模块找不到问题主要是两个配置冲突和加载顺序错误导致的：

1. ES模块的import语法存在变量提升，你在index.js中写的@babel/register注册逻辑实际晚于业务模块导入执行，导致TS文件解析规则未生效
2. babel-node启动时默认仅识别.js扩展名，未配置TS扩展名识别规则

具体修复步骤 #

1. 修改启动命令，给babel-node添加TS扩展名支持 #

修改package.json中的start脚本，添加--extensions参数：

"start": "babel-node --extensions \".js,.ts\" src/index.js"

2. 修正index.js的加载顺序，避免import提升 #

ES模块的import会自动提升到代码最顶部执行，导致@babel/register还没注册就已经加载了后续业务模块，直接把index.js改写为CommonJS规范的加载方式：

require('core-js/stable');
require('regenerator-runtime/runtime');

// 先注册babel规则
require('@babel/register')({
  extensions: ['.js', '.ts'],
  ignore: [/node_modules/],
});

// 注册完成后再加载业务模块，使用require而不是import
const Main = require('./Main').default;

const start = async () => {
  try {
    const app = new Main();

    await app.initConfig();
    app.initContainer();
    app.initServer();
  } catch (error) {
    console.error(error);
    process.exit(1);
  }
};

start();

3. 可选优化：移除冗余配置 #

如果你用babel-node启动，已经内置了编译逻辑，可以直接删除index.js中的@babel/register相关代码，避免重复注册冲突，修改后的index.js可以简化为：

import 'core-js/stable';
import 'regenerator-runtime/runtime';
import Main from './Main';

const start = async () => {
  try {
    const app = new Main();

    await app.initConfig();
    app.initContainer();
    app.initServer();
  } catch (error) {
    console.error(error);
    process.exit(1);
  }
};

start();

4. 验证排查 #

如果修改后还是报错，可以先尝试在导入TS文件时主动加上.ts后缀验证：

import findById from './findById.ts';

如果能正常加载，说明是扩展名解析规则问题，可以检查babel-plugin-module-resolver的配置是否正确，你当前的配置已经包含了.ts扩展名，通常按前两步修改后即可解决。

内容的提问来源于stack exchange，提问作者Alejandro Otero Gómez