Beyond "Clean Code": Why Your Comments Matter
2 days ago
- 注释是必要的,用于表达意图和'为什么'的信息,这些是逻辑本身无法传达的。
- Bob大叔声称'注释总是失败的'过于极端,而且可能有害。
- 逻辑只显示代码做了什么,而不显示程序员的意图或决策背后的推理。
- 注释应该用于自然地沟通,而不扭曲逻辑。
- 关于注释说谎或过时的反对意见,比起完全没有注释来说问题更小。
- 注释既能改善好代码也能改善坏代码;它们不是糟糕代码的拐杖。
- 作者挑战批评者:在不丢失信息或扭曲逻辑的情况下删除注释。