10.3.1 编码规范：命名、可读性、注释

文档摘要

10.3.1 编码规范：命名、可读性、注释在代码的世界里，命名不是修辞练习，而是一场精密的语义编码；可读性不是主观感受，而是可被静态分析工具量化、被新成员30分钟内理解、被自己六个月后无需重读三遍就能修改的工程指标；注释更不是文档的廉价替代品，而是编译器无法执行、但人类大脑必须依赖的“语义补丁”。我们常把编码规范当作入门手册里的礼仪守则——仿佛只要驼峰命名、加空格、写个就算尽了本分。可现实是：一个命名模糊的变量会让调试耗时翻倍；一段缺乏上下文的注释会诱使开发者写出逻辑冲突的修复；而所谓“清晰”的代码，往往在第三轮重构后才真正浮现它本该有的形状。这不是风格之争，而是成本博弈。