VSCode Code Runner运行TypeScript遇ES模块及export错误求助

你纠结的点其实是：为啥教程里不用tsconfig.json就能跑TypeScript代码，到你这儿就必须加配置才能正常执行？主要是这几个原因：

1. ts-node的默认配置随环境变化 #

ts-node本身有一套默认编译选项，但这套选项不是固定的——它会跟着Node.js版本、ts-node版本甚至运行环境变动：

• 要是用的是旧版ts-node（比如v10之前的部分版本）或者Node.js 16及以下，ts-node默认的module选项是CommonJS，编译出来的代码刚好符合Node.js默认的模块规范，自然不用额外配置就能跑。
• 你用的是ts-node 10.9.2 + Node.js 20，这时候ts-node默认的module选项可能变成了ESNext（或者和当前Node.js支持的模块模式对齐），编译后的代码会用ES模块语法（比如export）。但Node.js 20在没给package.json加"type": "module"的情况下，默认会把文件当CommonJS模块处理，这就直接导致了Unexpected token 'export'的语法错误。

2. 教程的环境和你的不一致 #

教程里能无配置运行，大概率是基于这些场景：

• 用的是低版本Node.js（比如Node.js 16及以下），这类版本对ES模块的兼容性要求更低，或者ts-node在对应环境下默认输出CommonJS代码。
• 教程里可能隐式存在package.json并设置了"type": "module"，只是没明确提及这一步；或者教程用的是先tsc编译再用node运行的方式，而非直接用ts-node，刚好适配默认配置。
• 教程可能使用了ts-node的特定启动参数（比如--commonjs），强制以CommonJS模式编译运行，只是没把这步写出来。

3. Code Runner扩展的影响 #

你最初用Code Runner运行时出现错误，除了tsconfig的问题，还可能是Code Runner的默认运行命令没适配你的环境：

• Code Runner可能在运行时添加了额外参数，或者默认的模块解析逻辑和你直接在终端执行ts-node index.ts不同，触发了ES模块模式的冲突。而添加tsconfig.json明确指定"module": "commonjs"后，强制ts-node输出CommonJS代码，冲突自然就解决了。

总结 #

教程里的“无需额外配置”是基于特定环境（Node.js版本、ts-node版本、甚至隐式的配置文件）实现的。在你的Node.js 20 + ts-node 10.9.2环境下，要么通过tsconfig.json明确指定"module": "commonjs"，要么在package.json里加"type": "module"并调整ts-node的模块配置，才能避开模块语法的冲突。

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