代码整洁度对 AI 编程代理的影响：arxiv 论文解读

一篇发布在 arxiv 上的论文 "Does Code Cleanliness Affect Coding Agents?" 在 Hacker News 上引发了 175 分的热议。论文的核心结论简洁有力：代码越整洁，AI 代理越聪明。

实验设计

研究团队选取了 200 个 Python 项目，每个项目生成两个版本：整洁版（原始代码）和混乱版（通过自动化工具打乱变量名、删除类型注解、增加冗余嵌套）。然后让 5 个主流 AI 编程代理（Cursor、Claude Code、Copilot、Windsurf、Aider）在两套代码上完成相同的 50 个编程任务。

图1：实验设计——同一项目生成整洁版和混乱版，隔离代码整洁度的影响

关键发现

论文的核心发现可以归纳为三点：

第一，影响是普遍的。所有 5 个代理在混乱代码上都表现更差，没有任何一个免疫。最稳定的 Claude Code 下降了 14 个百分点，最脆弱的 Aider 下降了 19 个百分点。

第二，影响是非线性的。当代码同时存在多种"噪音"（模糊命名 + 深层嵌套 + 混合关注点）时，准确率下降不是简单叠加，而是呈指数恶化。单一噪音因素的影响约 5-8 个百分点，但三重叠加可达 20+ 个百分点。

第三，代码结构的"信号密度"比代码量更重要。一个 200 行的高质量函数（清晰命名、类型注解、扁平结构）比一个 50 行的混乱函数更容易被 AI 理解。这颠覆了"短函数总是更好"的传统认知——关键不是长度，而是信噪比。

图2：信噪比与 AI 准确率的关系——非线性恶化，多重噪音叠加呈指数影响

从 Clean Code 到 Context Engineering

论文的最大贡献不是发现了"整洁代码更好"（这在直觉上显而易见），而是量化了影响的程度和模式，并提出了"上下文工程"作为传统 Clean Code 的延伸。

Clean Code 面向人类阅读者：减少认知负荷、提高可维护性。上下文工程面向 AI 阅读者：优化注意力分配、减少推理链断裂。两者的交集很大——好的命名对人和 AI 都有益——但也有差异：人类可以跳读、推断模糊命名，而 AI 在 token 稀缺时更容易被误导。

实践建议

对于正在使用 AI 编程代理的团队，论文给出了三条直接可操作的建议：

1. 在引入 AI 代理前先做代码清理：特别是命名规范化和类型注解补充，投入小、回报大。
2. 将 AI 代理的上下文质量纳入代码审查：不只审查代码做了什么，还要审查"AI 能否理解这段代码"。
3. 避免 God Class 和超长函数：这不仅是代码坏味道，更是 AI 代理的性能杀手。

[关联推荐]

• Short Leash：AI 编程方法论 -- 资深开发者的 AI 编程实践
• 2026 AI 编程代理格局 -- 从 Cursor 到 Claude Code 的代理界面演进
• 2026 Agent 编程巨变 -- 从"人写代码"到"人指挥 AI Agent 写"

---