# 第二章 整洁与规范

> 人机协同下的代码自律与规范选型

---

LLMS 索引： [llms.txt](/llms.txt)

---

很多人玩过一款经典的方块堆叠游戏:屏幕上方的方块来回滑动,玩家点击使其落在前一个方块上。一旦对齐产生偏差,超出下层边界的部分就会被直接切除。每一次微小的错位,都会让后续方块的有效承托面积(横截面)进一步缩小。几轮失误累积之后,顶部的接触面缩减为细针,轻微的扰动就会导致整个结构轰然倒塌。

在人机协同开发中,代码库的演进机制与此高度相似。

大语言模型编写代码的速度固然极快,但每一次功能的追加与重构,都必须承托在既有的代码基座之上。如果前序代码缺乏清晰的边界、充斥着隐式的反射黑魔法、混乱的包依赖或模糊的数据类型,那么后续迭代能够安全落脚的"可理解横截面"就会急剧收窄。

在混乱的架构中,代码生成得越快,技术债务滚雪球的速度也越快。当会话上下文被各种脆弱的暗坑与框架样板塞满时,模型面对的是一个摇摇欲坠的针尖:修补一个参数可能会破坏全局状态,新增一个接口可能会引发难以排查的并发隐患。最终,生成速度非但无法转化为交付效率,反而沦为生产事故的加速器。

要想让自动化协作维持长期、高频且稳健的迭代,关键在于**维护每一层代码基座的平整与宽阔**--即代码的显式表达、高可读性与确定性契约。代码的整洁与规范并非某种教条的审美偏好,而是支撑人机协同持续拓展的底层约束。

在人机协同开发时代,代码的阅读与推演主体不仅是工程师团队,还加入了大语言模型。人类或许能够依靠团队内部的口头默契和历史经验绕过隐晦的设计暗坑,但模型每一次推导、重构与代码生成,都完全受限于有限的会话上下文与当前文件中的确定性线索。

因此,无论选择收敛传递依赖优先使用现代标准库、选用零依赖透明库,还是用静态编译生成替代运行时反射,其核心目标都是**消除隐式假定、压降认知摩擦**。通过维护代码基座的平整与自律,守护住稳固宽阔的工程承托面,让自动化生成得以安全加速。

---

本节页面：

- [标准库优先:先穷尽内置,再引入外部](/ai-book/02-tidy-and-standard/01-use-std/): 减少外部传递依赖,保持代码基座的整洁与可理解性
- [依赖甄选:单一职责、零传递、接口透明](/ai-book/02-tidy-and-standard/02-good-pkg/): 杜绝臃肿与传递依赖,维持纯粹透明的调用链路
- [SQL 即源码:用 sqlc 构建零反射数据访问层](/ai-book/02-tidy-and-standard/03-orm-sqlc/): 编译期类型检查与零反射数据访问层的工程实践
- [Linter: 规范从软约束变成硬门禁](/ai-book/02-tidy-and-standard/04-static-gates/): 让 Linter 成为 AI 代码的第一道门禁