tsc配置nodenext/node16模块解析时相对导入需显式扩展名问题

nodenext/node16 模块解析模式的强制扩展名校验，是TypeScript团队对齐Node.js原生稳定版ESM规范做的设计：

• Node.js 原生ESM运行时默认不支持自动补全相对导入的文件扩展名，也不会默认解析目录下的index.js入口
• 你当前启动命令里用的--es-module-specifier-resolution=node是Node.js的实验性特性，从未进入稳定版标准，官方早已标记为废弃，存在后续版本被直接移除的风险
• TypeScript做该模式校验的核心逻辑是：只要过了tsc的校验，代码在Node.js稳定版ESM环境下就能直接运行，不会为非稳定的实验性flag做特殊兼容，因此强制要求显式写全扩展名，避免代码在无flag环境下直接运行报错。

不需要手动给所有源码补全后缀，可根据自身项目场景选以下方案：

• 调整tsconfig模块解析配置
  将tsconfig.json中的moduleResolution字段从nodenext改为bundler即可。该模式是TypeScript 5.0+专门为SWC、Rollup、Vite这类转译/打包工具场景设计的，不会强制要求相对导入携带显式扩展名，同时完整支持ESM相关的类型校验规则，跑tsc --emitDeclarationOnly生成类型声明时不会触发扩展名报错，和你当前的SWC编译流程完全适配。
• 编译阶段自动补全扩展名
  保留nodenext配置的前提下，通过SWC插件或者简单的预处理脚本，在编译环节自动给所有相对导入路径补全.js后缀，开发阶段源码维持无扩展名的写法，不需要手动修改业务代码，编译产物和类型生成都能符合校验要求。
• 适配原生规范写后缀
  实际在TypeScript源码里写import Example from './example.js'时，TypeScript会自动定位到同目录下的./example.ts文件做类型检查，不需要你真的创建.js源文件，SWC编译时也不会因为路径写了.js出现异常，最终编译产物的导入路径本身就是.js后缀，就算去掉--es-module-specifier-resolution=node启动参数也能正常运行，长期兼容性更好。

提示：Node.js官方已明确不推荐在生产环境依赖--es-module-specifier-resolution=node特性，该参数未来会被正式移除，长期项目建议尽量对齐原生ESM规范做适配。

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