p.17方法⏱ 约 3 分钟
陷阱 #17:命名与风格不一致
一会儿驼峰一会儿下划线,读着费劲
🔎 最后验证 2026-05📚 来源:《AI编程实战三卷书》卷二 §8–12🧰 Claude Code✅ 77 人学过👁 118 次阅读
为什么学这个
AI 生成的代码,常常这段用驼峰 userName、那段用下划线 user_name;这里缩进两格、那里四格;命名一会儿英文一会儿拼音。单看都能跑,合在一起却像"几个人风格各异地拼出来的",读着累、也容易出错。
💡 打个比方
就像一份文档,前一段宋体、后一段楷体,标题忽大忽小——内容也许都对,但读起来别扭、不专业,还容易让人看漏看错。代码风格不统一,就是这种"排版混乱"。
这个坑长什么样
- 命名混用:
userName/user_name/UserName混着来 - 缩进、引号(单/双)、分号加不加,前后不统一
- 中英混杂:一会儿
count,一会儿shuLiang
为什么会犯 & 怎么识别
- 为什么:AI 没有稳定遵循"你这个项目的"统一约定(尤其多轮生成时,呼应 #15)
- 识别信号:同类东西有多种命名/格式;新代码和已有代码"风格对不上"
怎么防
- 把风格约定写进 CLAUDE.md(m.3):命名规则、缩进、语言,定下来它每次都遵守
- 用工具自动统一:格式化工具(如 Prettier)能一键统一格式,让风格不靠人盯
- 让它对齐现有风格:"请按项目已有的命名和格式风格来写"
❓ 测验
怎么让 AI 稳定地遵守你项目的命名和格式风格?
⚠️ 避坑风格不一致是小事,但它是'失控'的早期信号
命名风格乱本身危害不大,但它常是"项目正在失去统一约定"的信号——往往伴随前后矛盾(#14)、忘约定(#15)一起出现。看到风格开始乱,提醒自己:该把约定固化、该收一收上下文了。
🤖 统一风格(收藏)
请检查并统一这个项目的代码风格:命名规则(统一用驼峰还是下划线)、缩进、引号、是否加分号、中英文使用。先告诉我你建议的统一约定,我确认后你统一改,并把约定写进 CLAUDE.md。
🔎 来源与核验· 1 条,点开核对
本节每个关键论断都对应一个可追溯的来源 —— 这是本课程"靠谱、不过时"的底线。
「AI 生成代码常风格不一致,应以 CLAUDE.md 约定与格式化工具统一」
📚 《AI 编程实战三卷书》卷二 §8–12✓ 已核验 2026-05
🔧 试一试:分几次让它加代码(4 分钟)
分几次、隔开时间让 AI 往同一个文件加代码。
你会看到:前后的命名(驼峰/下划线)、引号、缩进风格可能不一致——像几个人拼的。
怎么防:项目里配好 formatter/linter 自动统一;风格约定写进 CLAUDE.md。
✅ 小结
风格统一了。下一节是个特别隐蔽、还会给你虚假安全感的坑:AI 写的"假测试"。
下一节 → 陷阱 #18:测试造假
都看到这了，打个赏呗！
接下来 · p.18
陷阱 #18:测试造假
继续读下一节 →