《代码整洁之道》笔记03——注释

注释是在代码表达意图时遭遇的失败。

注释不能美化糟糕的代码

用代码来阐述

好注释

  1. 法律信息
  2. 对基本信息的注释
  3. 对意图的解释
  4. 阐释
  5. 警示
  6. TODO注释,程序员认为应该去做,但是由于一些原因没用实现完的注释。
  7. 放大不合理之物的重要性
  8. 公共API描述

坏注释

  1. 喃喃自语/废话注释
  2. 多余的注释
  3. 误导性注释
  4. 循规式注释:不需要给每一个函数进行注释
  5. 日志式注释
  6. 能用函数和变量时就别用注释
  7. 用于位置标识的注释
  8. 注释的代码
  9. 信息过多
  10. 不明显的联系
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章