TypeScript项目中：ts-node无法执行.ts文件，如何解决？

陆砚码

2026-09-22 • 👁 1人浏览过

使用ts-node运行TypeScript文件时遇到的难题及解决方案在基于TypeScript的Node.js项目中，ts-node通常用于直接运行TypeScript代码，避免了编译成JavaScript的额外步骤。然而，有时ts-node无法识别

.ts

文件扩展名，导致执行失败。本文将通过一个案例分析并提供解决方案。案例：开发者尝试使用ts-node运行包含自定义类的TypeScript文件。项目包含

src/index.ts

(定义Animal和Person类) 和

test/testPerson.ts

(导入并使用Person类)。执行

ts-node test/testPerson.ts

时，首先出现

TypeError: Unknown file extension ".ts"

错误，表明ts-node无法识别

.ts

文件。移除

package.json

中的

"type": "module"

字段后，又出现

SyntaxError: Cannot use import statement outside a module

错误。错误原因分析：这两种错误都与Node.js的模块系统和TypeScript配置有关。

"type": "module"

指定项目使用ES模块系统，需要

import

和

export

语句。而旧版Node.js或ts-node默认使用CommonJS模块系统，不支持

import

语句。移除

"type": "module"

解决了ES模块语法错误，但导致ts-node无法识别

.ts

扩展名。解决方案： TypeScript-45分钟入门课件源码 TypeScript-45分钟入门课件源码下载关键在于配置TypeScript编译器选项，使其支持ES模块的互操作性。在

tsconfig.json

中添加

"esModuleInterop": true

选项，允许TypeScript编译器在ES模块和CommonJS模块之间进行互操作，解决

SyntaxError

错误。为了使ts-node正确处理ES模块，应使用

ts-node-esm

命令执行TypeScript文件。常见问题解答：

package.json

中

"type": "module"

的作用是什么？它声明项目使用ES模块系统而非CommonJS系统。ES模块具有更好的模块化和性能。发布到npm时，

"type": "module"

会产生影响吗？这取决于目标用户使用的Node.js版本。如果目标用户使用支持ES模块的Node.js版本，则推荐使用

"type": "module"

。如果需要兼容旧版Node.js，则可能需要使用CommonJS模块系统或同时提供两种模块系统支持。如何解决

SyntaxError: Cannot use import statement outside a module

错误？在

tsconfig.json

中设置

"esModuleInterop": true

，并使用

ts-node-esm

运行TypeScript文件。通过以上步骤，可以有效解决ts-node无法执行

.ts

文件的问题，确保TypeScript项目能够顺利运行。

相关文章