Note4代码简洁之道-Chapter4
作者:
Terry | 来源:发表于
2019-07-10 12:00 被阅读0次
- 注释的的恰当用法是弥补我们在用代码表达意图时遭遇的失败。
- 程序员应该花更多的心思把代码的真实意图表达清楚，准确。
- 注释不能美化糟糕的代码。
- 有时候代码本身不足以解释其行为。
if(person.isNew & HOURLY_FLAG)&& person.age>65)
or
if(person.isEligibleForFullBenefits())
- 真正的好的注释是你想办法不去写的注释。
- 注释可以放大某种看来不合理之物的重要性。
- 想想如果没有JAVA doc我们该如何使用JAVA API？
- 简单的函数是多余的。
- 拒绝写废话注释。
/**
* Return the day of the month.
*/
public int getDayOfMonth(){
return dayOfMonth;
}
- 直接把代码注释掉是讨厌的做法。直接删掉，我们有先进的源代码系统如此之久，这可以直接删掉。
writeNote();
// writePaper();
writeEnd();
本文标题：Note4代码简洁之道-Chapter4
本文链接：https://www.haomeiwen.com/subject/dbezhctx.html
网友评论