使用ts-node运行TS代码报Cannot use import statement outside a module错误问询

问题成因 #

报错的核心原因是Node.js运行时的模块规范和TypeScript编译输出的模块规范不匹配：

1. 初始Cannot use import statement outside a module报错，是因为代码中使用了ES模块的import语法，但Node默认将执行文件识别为CommonJS模块，不支持顶层import语句
2. 新增"type": "module"后触发新报错，是因为你的tsconfig.json中compilerOptions.module配置为commonjs，TypeScript会把import语法转换为CommonJS规范的require调用，但此时Node已经将所有.js文件识别为ES模块，两种模块规范冲突导致报错。

解决方案（保留现有TypeScript代码，改动最小） #

方案1：使用CommonJS兼容模式（推荐） #

该方案无需修改业务代码，适配性更高：

• 移除之前在package.json中添加的"type": "module"配置，不要修改.ts文件扩展名
• 确认tsconfig.json中以下配置保持正确（你现有配置已符合要求，无需额外修改）：

  {
    "compilerOptions": {
      "module": "commonjs",
      "esModuleInterop": true
    }
  }
  

• 重新执行启动命令即可：

  npx ts-node src/server.ts
  

  如果仍有缓存导致的报错，可以添加跳过项目配置参数执行：

  npx ts-node --skip-project src/server.ts
  

方案2：保留ES模块规范 #

如果项目需要使用ES模块特性，可以按以下步骤调整：

• 保留package.json中的"type": "module"配置
• 修改tsconfig.json中的编译配置：

  {
    "compilerOptions": {
      "module": "NodeNext",
      "moduleResolution": "NodeNext",
      "target": "ES2022"
    }
  }
  

• 使用ES模块模式运行ts-node：

  npx ts-node --esm src/server.ts
  

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