我为什么开始讨厌 TypeScript？

我为什么开始讨厌 TypeScript？

在 2025 年的前端圈，说自己不喜欢 TypeScript，几乎是一种“政治不正确”。现在你去面试，如果说自己的项目没用 TS，面试官看你的眼神都会有点奇怪。

坦白说，我曾经是 TS 最忠实的拥护者。大概五六年前，我几乎是在团队里力排众议，强力推行 TS，把好几个旧的 JS 项目都重构了一遍。我享受过它带来的所有好处：智能的类型提示、重构时的安全感、以及那种把代码写得像诗一样严谨的快感。

但最近，尤其是在做一些需要快速迭代、频繁试错的小项目时，我发现，我好像开始“讨厌”它了。

这种“讨厌”，不是因为它不好，恰恰相反，可能是因为它“太好”、“太重”了。

我们为“类型安全”的付出

没有什么东西是只有好处没有代价的，TypeScript 也一样。我们享受了它的类型安全，但我们也在不知不觉中，为它付出了三种代价。

1. 还没开始写代码，就先配置 tsconfig.json

每个新项目，tsconfig.json 都是第一道坎。target 是 ES5 还是 ES2020？module 用 CommonJS 还是 ESNext？moduleResolution 选 node 还是 bundler？strict 模式要不要开？paths 路径别名怎么和 Vite 或者 Webpack 对齐？

这些配置，每一个背后都代表着一堆需要去理解的概念。有时候，光是让 TS 和构建工具、测试框架、ESLint 和谐共处，就得花上半天甚至一天的时间。

我只是想写个简单的业务逻辑，却要先成为一个“配置专家”，这个过程真的很消耗耐心。

2. 我的类型，比我的逻辑还复杂

给简单的变量和函数加类型，很愉快。但一旦你的逻辑变得复杂，比如处理一个泛型工具函数，或者一个嵌套很深的数据结构，类型体操就开始了。

我遇到过好几次，一个函数的实现逻辑可能只有 20 行，但我为了让它的类型完美无缺，写的 type、interface、extends、infer 这些东西，加起来超过了 50 行。

这个时候我总会问自己：我到底是在写业务代码，还是在“取悦”TypeScript 的编译器？

这种为了类型而类型，在追求完美的同时，也实实在在地拖慢了我的开发速度。代码的可读性，有时甚至不升反降。

3. 总有那么几个拖后腿的第三方库

TS 的生态很好，但不是完美的。你总会遇到那么一两个你想用的库：

• 它本身是 JS 写的，官方没有提供类型定义。
• 社区的 @types/xxx 包，要么没人维护了，要么类型写得有错误。

然后，你就陷入了窘境。你要么花大量时间去给它手写一个.d.ts 声明文件，要么就只能忍气吞声地使用 any 或者 // @ts-ignore。

每当这个时候，TS 带来的安全感就荡然无存，只剩下被一个第三方库的类型问题卡住的挫败感。

我们真的需要它吗？

上面说的这些，在一个大型、长期、多人协作的项目里，我认为是值得付出的。这种项目，稳定性和可维护性压倒一切。TS 倒是保证了规范。

但我开始“讨厌”TS，是在那些小规模、需要快速试错的场景里。

比如，我要快速搭一个原型去验证一个想法，或者做一个生命周期可能只有三个月的营销活动页面。在这种场景下， “快”是第一位的。

这时候，TS 就变得很重。API 的结构可能一天变三次，数据字段天天都在增删，我大部分的时间，都花在了和各种类型定义作斗争上，而不是快速地实现功能、收集反馈。

使用场景用错了，它反而变得碍手碍脚。

我的优雅解决方案：回归 JSDoc

在感到疲惫之后，我开始尝试一种“中间路线”：在.js 文件里，用 JSDoc 来做类型注解。

TypeScript

// 以前的 TS 写法functiongetUser(userId:string):Promise<User>{// ...}

JavaScript

// 现在的 JSDoc 写法/** * 获取用户信息 * @param {string} userId - 用户 ID * @returns {Promise<import('./types').User>} */functiongetUser(userId){// ...}

我发现，在 VSCode 强大的支持下，这种方式几乎能提供 TS 80%的好处：

1. 有智能提示：函数的参数、返回值类型，一清二楚。
2. 有类型检查：开启 // @ts-check 后，简单的类型错误也能被发现。
3. 没有编译时：它就是纯粹的 JS，不需要 TS 的编译过程，启动和构建都更快。
4. 它是“可选的” ：我可以只在我认为最关键的地方（比如 API 边界、复杂函数）加上 JSDoc，而在一些简单的内部逻辑里，享受纯 JS 的灵活性。

所以，我现在“讨厌”TypeScript 吗？

我想，我讨厌的，不是 TS 本身，而是那种“所有项目都必须上 TS”的“技术正确”。

我厌倦的，是的配置、是日益复杂的类型体操、是在项目初期就被类型束缚住手脚的感觉。

技术不是信仰，它只是工具箱里的工具。我们应该根据要解决的问题，来选择最合适的工具。

也许，最好的开发者，不是掌握了最“好”的工具的人，而是最清楚在什么场景下，选用“最合适”的工具的人。

你们觉得呢？😀