TypeScript运行时深度对比

# 1. 编写 TS 代码
# index.ts
const a: number = 10
console.log(a + 5)

# 2. 手动编译
tsc index.ts

# 3. 执行编译后的 JS 文件
node index.js

# 1. 初始化配置
tsc --init

# 2. 配置 tsconfig.json
{
  "compilerOptions": {
    "module": "commonjs",
    "target": "ES2020"
  }
}

# 3. 执行 TS 文件
ts-node index.ts

# 直接执行，无需配置
tsx index.ts

# 输出：15

排名  运行时       下载量趋势               主要应用场景
1⃣   ts-node     ████████████████       TypeScript 官方生态
2⃣   esbuild    ████████████           Vite 依赖预构建引擎
3⃣   JITI        ████████               Nuxt 3/Unbuild
4⃣   SWC         ██████                 Next.js/Turbopack
5⃣   TSX         ███                    新兴零配置工具

// 直接执行 TypeScript 代码
ts-node script.ts

// REPL 交互模式
ts-node
> const a: number = 10
> console.log(a + 5)
15

Go 语言编写
    ↓
极快的编译速度（比 tsc 快 10-100 倍）
    ↓
Vite 的依赖预构建与转译引擎

Nuxt 3 SSR 框架
    ↓
服务端 TypeScript 编译
    ↓
使用 JITI 运行时

// Nuxt 3 架构
├─ 开发模式：Vite（esbuild）
├─ 服务端渲染：JITI
└─ 模块处理：JITI + esbuild

Rust 语言编写
    ↓
单线程性能极强
    ↓
Next.js / Turbopack 底层引擎

编译速度：SWC > esbuild > ts-node
功能完整度：ts-node > esbuild > SWC

# 零配置执行
tsx index.ts

# Watch 模式
tsx watch index.ts

# REPL 模式
tsx

// CommonJS 模块作用域变量
module.exports    // 导出对象
exports           // 导出对象别名
require           // 引入函数
__filename        // 当前文件绝对路径
__dirname         // 当前文件所在目录

TSX、ts-node：完整支持 
SWC：部分支持 （某些语法不支持）

// 场景 1：在 TS 文件中导入 JS 文件
import { foo } from './bar.js'

// 场景 2：在 .cjs 文件中导入 TS 文件
const ts = require('./typescript.ts')

// 场景 3：导入 .cts/.mts 文件（TS 新后缀）
import { util } from './utils.mts'

TSX > ts-node > JITI > esbuild > SWC

// 可以 require 哪些文件？
require('./file.js')      // JS 文件
require('./file.ts')      // TS 文件
require('./file.cjs')     // CJS 文件
require('./file.mjs')     // ESM 文件（关键！）

.ts   → 普通 TypeScript 文件
.cts  → CommonJS 规范的 TypeScript 文件
.mts  → ES Module 规范的 TypeScript 文件

// utils.mts
export function add(a: number, b: number): number {
  return a + b
}

// main.ts
import { add } from './utils.mts'  // TSX 完美支持

启动速度：SWC ≈ esbuild > TSX > JITI > ts-node
执行速度：SWC ≈ esbuild > TSX > JITI > ts-node
缓存效率：TSX > SWC ≈ esbuild > ts-node > JITI

// tsconfig.json
{
  "compilerOptions": {
    "module": "commonjs",
    "target": "ES2020",
    "strict": true
  },
  "ts-node": {
    "compilerOptions": {
      "module": "commonjs"
    }
  }
}

# 直接执行，无需任何配置文件
tsx script.ts

你的需求是什么？
│
├─  需要完整类型检查
│   └─ 使用 ts-node
│
├─  追求极致性能
│   ├─ Rust 技术栈 → SWC
│   └─ Go 技术栈 → esbuild
│
├─  零配置快速开发
│   └─ 使用 TSX
│
├─  Nuxt 3 项目
│   └─ 使用 JITI（已内置）
│
├─  需要完整功能支持
│   ├─ ESM + CJS 混合 → TSX
│   └─ 传统 CommonJS → ts-node
│
└─  实验性项目尝鲜
    └─ SWC 或 TSX

推荐：TSX 或 ts-node
理由：
- TSX：零配置，开发快
- ts-node：类型检查完整，生产稳定

推荐：TSX
理由：
- 零配置，快速测试
- 支持各种模块格式
- 开发体验好

推荐：SWC（已内置）
理由：
- Next.js 12+ 默认使用 SWC
- 无需额外配置
- 性能最优

推荐：JITI（已内置）
理由：
- Nuxt 3 默认使用 JITI
- SSR 场景优化
- 与 Vite 配合良好

# 1. 安装 TSX
npm install -D tsx

# 2. 编写 CLI 代码
# src/cli.ts
#!/usr/bin/env node
import { program } from 'commander'

program
  .version('1.0.0')
  .command('build')
  .action(() => {
    console.log('Building...')
  })

program.parse()

# 3. 在 package.json 中配置
{
  "bin": {
    "my-cli": "dist/cli.js"
  },
  "scripts": {
    "dev": "tsx src/cli.ts",
    "build": "tsup src/cli.ts"
  }
}

# 4. 开发时直接运行
npm run dev build

# 方案 1：ts-node（传统）
npm install -D ts-node @types/node @types/express
npx ts-node src/server.ts

# 方案 2：TSX（推荐）
npm install -D tsx
npx tsx src/server.ts

# 方案 3：TSX + Watch 模式
npx tsx watch src/server.ts

// 问题代码
const { default: config } = require('./config.mjs')
// ❌ ts-node 报错：Cannot require ES Module

// 解决方案：使用 TSX
tsx script.ts  // ✅ 可以正常运行

运行时（Runtime）：
  TSX、ts-node、JITI、SWC、esbuild-runner
  ↓
  用于开发阶段快速执行 TS 代码

构建工具（Build Tool）：
  Rollup、Webpack、Vite、Turbopack
  ↓
  用于生产环境打包编译

# 开发阶段：使用运行时
tsx src/index.ts

# 生产阶段：使用构建工具
vite build