TS编译后Node无法识别模块路径及扩展名问题求助

核心问题本质 #

你遇到的问题是Node的ESM模块解析规则和TS编译行为不匹配：

• Node运行ESM格式的代码时，要求导入路径必须带完整扩展名（.js/.mjs等），不像CommonJS可以省略扩展名自动查找。
• 你的TS配置用了"module": "es2022"，编译后生成的是ESM格式的.js文件，但TS源码中不带扩展名的导入（比如import mongo from './Utility/mongo'），编译后依然不会自动添加.js扩展名，导致Node找不到模块。

关于allowImportingTsExtensions报错的说明 #

这个报错不是核心问题，它只是TS的语法检查限制：开启该选项允许你在TS源码中直接导入.ts文件，但编译后这些路径不会自动转为.js，Node运行时依然会找不到模块，所以开启它解决不了根本问题。

无需手动给所有文件加扩展名，推荐以下解决方案 #

方案一：调整TS的模块解析策略（最推荐） #

将moduleResolution改为nodenext（或bundler，适合构建工具场景），TS会根据ESM规范自动处理导入路径：

• 源码中写不带扩展名的导入，编译后会自动为生成的.js文件添加正确的.js扩展名。
• 修改后的TS配置：

  {
    "module": "es2022",
    "moduleResolution": "nodenext",
    "target": "es2021"
  }
  

方案二：源码中手动写.js扩展名（临时应急） #

在TS源码中导入时直接写.js扩展名，比如：

import mongo from './Utility/mongo.js'

TS会自动映射到对应的.ts文件进行编译，编译后保留.js扩展名，Node就能正常识别。但这种方式需要手动修改所有导入语句，不推荐长期使用。

为什么编辑器能找到文件但Node找不到？ #

编辑器（如VS Code）会通过自身的路径解析逻辑帮你定位文件，但Node的ESM解析器严格遵循ESM规范，必须带完整扩展名才能找到编译后的.js文件，两者的解析规则不同导致了这个差异。

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