Hasty Briefsbeta

双语

Beyond "Clean Code": Why Your Comments Matter

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