我厌倦了 Node.js 中混乱的 TypeScript 迁移，于是我构建了 fast-ts-integrator

Source: Dev.to

为已有的 Node.js 项目添加 TypeScript

为已有的 Node.js 项目添加 TypeScript 听起来很简单，直到它并不简单。

写了几文件后，通常会出现以下漂移：

• tsconfig.json 与实际运行时不匹配
• CommonJS 与 ESM 开始相互冲突
• .js 与 .ts 文件混杂让项目更难理解
• 测试和 lint 的配置增加了更多摩擦

我一次又一次碰到同样的墙，于是我构建了一个小型 CLI，让设置过程可预期。

它是什么

fast-ts-integrator 是一个 CLI，帮助在新项目或已有的 Node.js 项目中交互式地添加 TypeScript。

它让你可以选择：

• ES Modules 或 CommonJS
• tsx 或 ts-node
• Biome 或 ESLint + Prettier
• Vitest 或 Jest

随后它会安装所需依赖，生成配置，并添加脚本，让你可以真正开始编码，而不是与配置作斗争。

为什么我要构建它

大多数痛点并非 “TypeScript 本身”。
而是围绕它的配置：

• 选择合适的模块策略
• 保持运行时行为一致
• 迁移后避免破损的导入
• 在不把项目变成配置汤的前提下接入 lint 和测试

我想要一个对真实 Node.js 项目有效的实用方案，而不是空洞的演示。

快速开始

npx fast-ts-integrator

或

npx fast-ts

示例流程

CLI 会引导你完成几个选择：

• 模块系统
• 执行引擎
• Linter/formatter
• 测试框架

完成后，它会为你搭建好相应的结构并更新 package.json。

链接

• npm: fast-ts-integrator on npm
• GitHub: fast-ts-integrator repository

持续改进

这仍是早期版本，我正积极改进中。

真实的反馈会帮助很大，尤其是来自以下场景的朋友：

• 渐进式的 JS‑to‑TS 迁移
• CommonJS‑to‑ESM 的头疼问题
• 已有的 Express 或 Node 后端
• 在迁移过程中容易出错的 lint/测试配置

如果你尝试了它，我真的想了解哪些地方顺手，哪些地方让人烦恼。