读书笔记之代码整洁之道(Clean Code)

软件质量,不但依赖于架构及项目管理,而且与代码质量紧密相关。这一点,无论是敏捷开发流派还是传统开发流派,都不得不承认。《代码整洁之道》提出一种观念:代码质量与其整洁度成正比。干净的代码,既在质量上较为可靠,也为后期维护、升级奠定了良好基础。作为编程领域的佼佼者,《代码整洁之道》作者给出了一系列行之有效的整洁代码操作实践。这些实践在《代码整洁之道》中体现为一条条规则(或称“启示”),并辅以来自现实项目的正、反两面的范例。只要遵循这些规则,就能编写出干净的代码,从而有效提升代码质量。
《代码整洁之道》阅读对象为一切有志于改善代码质量的程序员及技术经理。书中介绍的规则均来自作者多年的实践经验,涵盖从命名到重构的多个编程方面,虽为一“家”之言,然诚有可资借鉴的价值。 –豆瓣

  • 有意义的命名
  • 方法
    • 标识参数丑陋(bool)
    • 抽离try-catch块
  • 注释
    • 不要留下注释后的代码
    • 方法描述中存在无用的循规式注释,需要建立统一的代码注释规范
  • 良好的代码格式
    • 统一团队的代码格式
  • 异常处理
    • 少用null
  • 边界处理
    • 尽量提供的api里不要用map
  • 单元测试
    • 快速(Fast)
    • 独立(Independent)
    • 可重复(Repeatable)
    • 自足验证(Self-validating)
    • 及时(Timely)
    • 三要素:可读性、可读性、可读性
    • 短小
    • 单一职责
    • 内聚
  • 边界
    • map
    • 学习性测试
  • 童子军军规
    • 当你离开一个地方的时候,要让它比你来的时候更加整洁干净
    • 重构
    • 单元测试
  • code smell
    • 注释
    • 环境
    • 函数
    • 一般性问题
    • java
    • 名称
    • 测试