笔记一

笔记一：代码质量的本质 —— 从 “能运行” 到 “可维护”
《代码大全》开篇便打破了 “代码只要实现功能就合格” 的固有认知，将代码质量明确界定为 “正确性、可读性、可维护性、效率、健壮性” 的有机综合体。书中着重强调，正确性是代码的底线，但可读性才是其生命线—— 在团队协作场景中，一段难以理解的高效代码，往往会成为后续迭代的 “技术债务”，不仅增加维护成本，还可能因二次开发引发新的 bug。作者提出的 “代码应该像英语散文一样易读” 这一观点令人印象深刻，这要求开发者在编码全流程建立规范：命名上需精准体现用途，如用userLoginTime记录用户登录时间，而非模糊的t；注释应聚焦 “为什么这么设计”，而非重复代码本身的逻辑，比如解释 “此处添加空值判断是因为第三方接口可能返回 null”，而非标注 “判断变量是否为空”；格式上通过统一缩进、合理空行构建视觉层次，让代码结构一目了然。此外，书中对 “防御性编程” 的阐述极具实践价值：通过输入验证、异常处理、断言等手段提前规避潜在风险，例如处理用户手机号输入时，不仅要校验 11 位数字格式，还要考虑区号、特殊字符等边界情况，甚至防范恶意注入攻击。这种从 “被动修复 bug” 到 “主动预防问题” 的思维转变，正是优质代码与普通代码的核心差距。