如何让ts-node/ts-node-dev兼容ECMAScript模块并实现热重载？

一、调整ts-node/ts-node-dev的运行参数 #

ts-node和ts-node-dev对ESM的支持需要明确组合多个参数，仅加--esm不足以覆盖所有场景，试试以下配置：

1. 直接命令行执行 #

• 针对ts-node：

  ts-node --esm --experimental-specifier-resolution=node src/index.ts
  

• 针对ts-node-dev：

  tsnd --esm --experimental-specifier-resolution=node src/index.ts
  

--experimental-specifier-resolution=node用于让Node.js沿用传统模块解析逻辑，避免文件扩展名识别异常。

2. 配置package.json的scripts命令 #

将debug命令修改为：

"scripts": {
  "debug": "tsnd --esm --experimental-specifier-resolution=node src/index.ts"
}

二、修正tsconfig.json的核心配置 #

确保以下配置项与ESM完全兼容：

{
  "compilerOptions": {
    "module": "NodeNext",
    "moduleResolution": "NodeNext",
    "target": "ES2020", // 最低选ES2020以支持完整ESM特性
    "esModuleInterop": true,
    "skipLibCheck": true,
    "strict": true,
    "outDir": "./dist"
  },
  "include": ["src/**/*"]
}

注意moduleResolution必须与module保持一致为NodeNext，否则会出现模块解析冲突。

三、解决文件扩展名报错问题 #

若出现"未知文件扩展名.mts"错误，检查并调整导入语句：

• ESM模块要求导入时必须指定文件扩展名，比如：

  // 错误写法
  import utils from './utils'
  // 正确写法
  import utils from './utils.ts'
  

• 若不想手动添加扩展名，确保Node.js版本在16.14以上，结合--experimental-specifier-resolution=node参数，同时在tsconfig.json中开启resolveJsonModule。

四、替代热重载方案 #

如果ts-node-dev仍无法兼容，可尝试以下成熟方案：

1. nodemon + tsc #

依赖官方编译流程，稳定性拉满：

• 安装依赖：npm install -D nodemon typescript
• 添加scripts命令：

  "scripts": {
    "dev": "nodemon --watch src --ext ts --exec 'tsc && node dist/index.js'"
  }
  

2. vite-node #

Vite官方的Node端工具，原生支持ESM，热重载速度快：

• 安装依赖：npm install -D vite vite-node
• 创建vite.config.ts：

  import { defineConfig } from 'vite'
  
  export default defineConfig({
    // 按需配置端口、环境变量等
  })
  

• 添加scripts命令：

  "scripts": {
    "dev": "vite-node src/index.ts"
  }
  

3. esbuild + nodemon #

利用esbuild的极速编译能力适配ESM：

• 安装依赖：npm install -D esbuild nodemon
• 添加scripts命令：

  "scripts": {
    "build": "esbuild src/index.ts --bundle --format=esm --outfile=dist/index.js",
    "dev": "nodemon --watch src --ext ts --exec 'npm run build && node dist/index.js'"
  }
  

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