惯性聚合 高效追踪和阅读你感兴趣的博客、新闻、科技资讯
阅读原文 在惯性聚合中打开

推荐订阅源

Recent Announcements
Recent Announcements
奇客Solidot–传递最新科技情报
奇客Solidot–传递最新科技情报
MongoDB | Blog
MongoDB | Blog
H
Help Net Security
钛媒体:引领未来商业与生活新知
钛媒体:引领未来商业与生活新知
人人都是产品经理
人人都是产品经理
freeCodeCamp Programming Tutorials: Python, JavaScript, Git & More
The GitHub Blog
The GitHub Blog
V
V2EX
Microsoft Security Blog
Microsoft Security Blog
V
Visual Studio Blog
A
About on SuperTechFans
博客园_首页
L
LangChain Blog
量子位
雷峰网
雷峰网
Cyber Security Advisories - MS-ISAC
Cyber Security Advisories - MS-ISAC
Jina AI
Jina AI
月光博客
月光博客
阮一峰的网络日志
阮一峰的网络日志
博客园 - 聂微东
Microsoft Azure Blog
Microsoft Azure Blog
M
MIT News - Artificial intelligence
N
Netflix TechBlog - Medium

博客园 - 洛晨随风

openclaw云端部署踩坑(持续更新) openspec的project.md要求模板 AI编程的残酷真相:为什么说Spec Coding是2026年最大的趋势? 🐳 Docker 核心实战与进阶笔记 python代码:ffmpeg.probe(视频路径) 出现系统找不到指定文件的问题处理办法 浅显易懂的解释一下RRF加权算法的意思 JS队列之双端队列介绍 hugging face 在windows 上的使用办法 大屏上cesium可能出现放大缩小后的坐标偏移问题采坑 windows 端使用gemini cli的办法 记一次插件发布的采坑经历 提示词记录 混合开发的一些小tips(uniapp+hbuilder x+vue3+vite+ 5+APP) AI的规则设置 项目打包时跳过TS类型检查的办法 cursor 配置MCP模式,以读取figma原型为例说明开发的便捷性 pnpm workspace 采坑 一些AI工具整理 解决谷歌翻译导致的HTML多加入<font style=“vertical-align:inherit;“>的问题
在 AI 编程狂热之后:为什么“文档与原理”才是开发者的真正护城河
洛晨随风 · 2025-12-11 · via 博客园 - 洛晨随风

在 AI 编程狂热的当下,许多开发者正在不自觉地陷入一种技术崇拜
仿佛只要 Prompt 足够巧妙,系统就能“自动生长”。

但真实的工程实践告诉我们一个不太体面的事实:
AI 经常画蛇添足,规则(Rules)会失效,幻觉无处不在。

本文源于我从一套 9000 行 AI 生成的屎山代码中爬出来的惨痛经验,试图回答一个更根本的问题:

在 AI 时代,什么才是真正不可被替代的能力?

结论很简单,也很反直觉:
不是代码生成,而是文档、原理与审查能力。

一、9000 行代码的“虚假繁荣”

我曾在 AI 的帮助下,极短时间内生成了一个三维水务管理系统的原型。

那一刻,看着编辑器里迅速增长到 9000 行的代码,我几乎确信:
效率革命已经发生。

但当第一个需求变更到来时,魔法迅速变成了诅咒。

我发现这些代码存在高度一致的问题:

  • 逻辑看似自洽,实则冗余

  • 状态管理混乱,边界不清

  • 在简单问题上疯狂抽象

  • 在核心业务上反而异常脆弱

AI 在很多地方“过度负责”,却在真正关键的地方缺乏判断。

那一刻我才意识到:

AI 是一个极其勤奋,但缺乏全局观的实习生。
如果你没有能力审查它,它就会用“看起来很努力”的低质量代码淹没你。


二、认知修正:AI 不是“许愿池”,而是“在校生”

很多人误以为:

把需求扔给 AI,系统自然就会出现。

这在复杂系统开发中几乎必然失败。

AI 的第一次实现,从来不是答案,而更像是一个“头脑风暴参考”(Brainstorming Reference)。
如果你直接照搬,结果往往是灾难。

开发的真实公式已经发生变化:

过去:
代码质量 = 开发者能力 × 开发时间

现在:
代码质量 = 架构约束 × 提示精度 × 人工校验与持续迭代

一个必须接受的现实是:

AI 生成的代码,默认不可信。
只有经过人的审查,它才“暂时可用”。


三、流程重构:文档先行,架构殿后

有一种流行说法是:“有了 AI,可以直接跳过设计阶段。”

我对此持明确的反对态度。

在 AI 时代,文档的重要性不是降低了,而是被放大了

1. 先有文档,后有骨架

我现在的开发流程中,有一条硬性原则:

不允许 AI 一上来就写代码。

正确顺序是:

  1. 人工编写详细的技术方案与业务文档

  2. 人工审核逻辑闭环,删除“看起来聪明但没有必要”的设计

  3. 在明确的约束下,才允许 AI 填充实现细节

没有被人类理顺的系统思维,AI 只会放大混乱,而不是解决问题。


2. 规则不是万能药

即便存在 .cursorrules 这类工具,现实依然很残酷:

  • 上下文一长,规则就会被“遗忘”

  • AI 会自信地调用不存在的 API

  • 会在不被允许的地方引入新抽象

规则只能辅助,不能替代人工干预。

解耦、分层、边界感,从来不是 AI 的本能,
而是架构师必须强制施加的约束。


四、真正的护城河:原理与反幻觉能力

这是我最想强调的一点:

为什么 2026 年,我们仍然必须学习底层原理?

1. 识破“一本正经的胡说八道”

AI 最危险的能力不是“不会写代码”,
而是会极其自信地胡说八道(Hallucination)。

例如在 GIS 开发中,AI 可能凭空捏造一个 Cesium API。
如果你不了解 WebGL 渲染机制、不熟悉 Cesium 的底层设计,你会在错误方向上排查半天。

只有理解原理,才能识别谎言。
这正是资深开发者与脚本调用者的本质差异


2. 拒绝“信息茧房”

完全依赖 AI 问答,会让人迅速陷入信息茧房:

  • 知识滞后

  • 概率压缩

  • 缺乏多源验证

在关键决策点,我仍然坚持:

  • 查官方文档

  • 看源码

  • 多信源交叉验证

保持怀疑,是对抗 AI 误导的唯一屏障。


五、被忽视的协作成本:AI 是“失忆的”

在多人协作的 AI 开发中,还存在一个常被忽略的问题:

AI 的有效能力高度依赖历史对话。

当一个开发者长期与 AI 共创同一系统时,
AI 实际上已经在反复纠错中形成了一套“隐性共识”。

但当系统交由另一位开发者时,这些共识并不会随代码一起交接。

代码是共享的,认知不是。

即便引入 Slack、协作平台或 AI 编辑器集成,
也只能解决“人之间的信息同步”,
却无法实现“AI 之间的认知同步”。


六、真正可扩展的解法:把 AI 的“脑子”外置化

现实中,唯一可规模化的解决方案并不在 AI 层,而在工程层:

  • 架构说明文档

  • 决策记录(ADR)

  • 禁止事项与反模式清单

  • 模块边界定义

这些文档的意义在于:

把原本存在于“某个人 + AI 对话中的隐性知识”,
转化为“所有人 + 所有 AI 都能读取的公共约束”。

文档不是给人看的说明书,
而是系统级 Prompt 的长期稳定版本


七、结语:分步骤的艺术

对于复杂的企业级系统,不存在“一键生成”。

正确的方式始终是:

  1. 拆解为极小步骤

  2. 让 AI 执行一小步

  3. 人工验证与审查

  4. 提出变更请求

  5. 让 AI 重构,而不是堆叠

AI 时代,我们不应该退化为“Prompt 工程师”,
而应该进化为:

技术鉴赏家、认知守门员,以及残酷的代码审查员。

AI 不会继承你的经验,但文档可以。
这,才是对抗幻觉与失忆的真正护城河。