使用 ts-node 直接运行 TypeScript 文件调试

应用场景

在日常开发中，我们经常需要编写和运行 TypeScript 脚本。本文将介绍两种主流的方案：使用 ts-node 和 tsx。

运行 TypeScript 脚本需要安装 ts-node，注意这个库需要局部安装：

yarn add -D ts-node typescript @types/node
# 或者
npm install -D ts-node typescript @types/node

{
  "compilerOptions": {
    "module": "ESNext",  // 或 "ES2015"
    "moduleResolution": "node", // 必须添加
    "esModuleInterop": true
  }
}

{
  "type": "module"
}

// ❌ 错误
import data from './data'
// ✅ 正确
import data from './data.js'

ts-node --esm ./script.ts
# 或者
node --loader ts-node/esm ./script.ts

tsx 是一个更现代的替代方案，基于 esbuild，提供更快的执行速度：

yarn add -D tsx
# 或者
npm install -D tsx

tsx ./script.ts

SyntaxError: Cannot use import statement outside a module

解决：在 package.json 中添加 "type": "module"

Error [ERR_MODULE_NOT_FOUND]: Cannot find module

解决：添加文件扩展名（.js 或 .ts）

TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".ts"

解决：使用正确的命令格式：node --loader ts-node/esm 或直接使用 tsx

ReferenceError: fetch is not defined

解决方案：

# 使用 ts-node 时需要安装
yarn add node-fetch
# 使用 tsx 时已内置，无需安装

工具	启动时间	配置复杂度	内存占用
ts-node	1-2s	需要配置	较大
tsx	0.1-0.5s	零配置	较小