为什么你用 AI 写代码，效率反而越来越低？尤雨溪的一个习惯，点醒了无数程序员

为什么你用 AI 写代码，效率反而越来越低？尤雨溪的一个习惯，点醒了无数程序员

你是不是也陷入过这样的怪圈？

接到一个开发需求，立刻打开 AI 对话框，直接输入：“帮我写一个 xxx 功能代码”。AI 秒速输出，你复制粘贴运行，结果满屏报错。把报错丢给 AI，它修改后再发，你再跑 —— 勉强通过。可仔细检查，逻辑漏洞百出、场景覆盖不全，来回返工四五轮，最后崩溃发现：还不如自己手写快。

如果你也有过这种体验，评论区告诉我，你不是一个人。

这不是你的问题，也不是 AI 的问题，而是你的工作流彻底错了。

最近刷到 Vue 创始人尤雨溪的分享，他使用 AI 辅助编码的方式，瞬间点醒了我。原来高手和普通开发者的差距，从来不是会不会用 AI，而是会不会让 AI 先帮你 “想清楚”，而不是直接 “动手干”。

尤雨溪提到，他现在做任何重大功能开发或架构改动前，都会先让 AI 进入plan mode（规划模式），优先输出一份完整的research/design doc（研究与设计文档）。这份文档会统一编号、存档、commit 到代码仓库，就像数据库的迁移记录一样，完整保留项目思考与进化的全部脉络。

他不是让 AI 直接写代码干活，而是让 AI 先帮他梳理思路、沉淀文档，把 “想” 和 “做” 之间架起一座稳固的桥梁。

这和我们绝大多数人的习惯完全相反：我们用 AI，是让它替我们做；尤雨溪用 AI，是让它帮我们想。

核心区别只有一个：思考权，始终握在自己手里。

我亲自验证了这套工作流，效果堪称颠覆。

上周我需要开发一个yaml格式化功能，放在以前，我会直接让 AI 生成代码，边测边改，边改边踩坑，写到一半才发现漏了场景、扩展性极差，返工成本极高。

这一次，我严格按照尤雨溪的方法执行：

第一步，先让 AI 进入 plan mode，明确告知：我要开发支持yaml格式化、易用的检索，不要写代码，先输出完整设计方案，包含需求分析、技术选型、UI设计、潜在风险、备选方案。

AI 很快输出了一份 2000 多字的专业文档，我一眼就发现了自己之前忽略的边界场景与扩展问题，补充完善、确认方案无误后，才让 AI 按照定稿文档进行代码实现。

最终结果：原本需要折腾一整天的任务，两小时高质量完成，代码逻辑严谨、扩展性强，几乎没有返工。

更惊喜的是，一周后我需要迭代该模块，打开存档文档，当时的设计思路、决策依据一目了然，不用重读代码，就能快速判断修改范围，效率翻倍。

代码会被不断重构，但设计文档里沉淀的思考脉络，才是项目最值钱的资产。

我把这套方法分享给身边程序员朋友，反馈高度一致：“以前用 AI 像碰运气，现在用 AI 像带靠谱实习生。”“文档写完那一刻，代码怎么写心里全有数了。”“AI 写的代码不值钱，帮我梳理的设计文档才是真核心。”

一位阿里后端的朋友说，团队一直推行 “设计先行”，但手写文档太痛苦，大家敷衍了事；现在用 AI 生成初稿，人工微调，质量比手写高太多，落地阻力几乎为零。

这正是尤雨溪这套方法的精髓：让 AI 帮你梳理思路，本质是倒逼自己先想清楚再动手，方向对了，执行才会高效，返工自然消失。

内部实验也印证了这一点：给 AI 堆砌 1000 页细节，它会迷失；给它一张清晰的地图，它能精准高效完成任务。而尤雨溪做的，就是给 AI 画好这张地图。

我结合尤雨溪的分享与实战经验，把这套高效工作流拆解为三步落地法：

第一步：开启 plan mode，先出设计文档

接到需求，绝不直接写代码。让 AI 先输出完整 design doc，必须包含：

• 需求背景与核心目标
• 技术方案选型与对比
• 数据结构 / 接口定义
• 潜在风险与兜底方案
• 未来扩展性设计

这一步的意义：把你脑子里模糊的想法，梳理成结构化、无漏洞的方案。

第二步：编号存档，commit 进仓库

将文档规范命名（如：design_20260225_用户权限模块.md），提交至代码仓库永久保存。正如尤雨溪所说，这就是项目的进化版本记录，新人接手、后期迭代，不用翻聊天记录，读文档即可一目了然。

第三步：基于定稿文档，让 AI 实现代码

方案确认后，再让 AI 按照文档编写代码。此时方向明确、约束清晰，AI 输出的代码准确率极高，几乎不用反复调试。

部分团队还增加了一步：用 “文档园丁 AI” 定期校验，保证文档与代码实时同步，彻底解决 “文档过时” 的行业痛点。

这套流程跑下来，你拥有的不再是一个工具，而是一个永不失忆、高效协作的结对编程伙伴。

尤雨溪也提到，他搭配 VoidZero 工具链，验证与效率拉满，但工具永远是锦上添花。最核心的，永远是：先写文档，再写代码。

如果你也想改变 AI 低效困局，从下一个需求开始尝试：别急着打开编辑器，先对 AI 说：帮我写一份 design doc，我想清楚再动手。

坚持一周，你会明显发现：返工少了、思路清了、AI 真正成为你的效率放大器。

工具再强大，也只是工具；会掌控工具、掌握正确工作流的人，才是最值钱的开发者。

最后一个灵魂提问：你用 AI 写代码时，属于哪一类？

A. 直接开干，能跑就行B. 先理思路，想清楚再干C. 看需求复杂度，简单直接干，复杂先规划D. 我有更骚操作，评论区分享

我选 B，毕竟踩过太多 “上来就干” 的坑。你呢？