formatting - 好的评论用例

我一直讨厌用星号填满一半屏幕的评论,只是为了告诉你函数返回一个字符串,我从来没有看过那些评论。

但是,我确实阅读了描述为什么完成某事以及如何完成的注释(通常是代码中的单行注释);这些在试图理解别人的代码时非常方便。

但是在写评论的时候,我不这么写,而是我只在编程比赛中写算法时才使用评论,我会想到算法会如何做,然后我会写每个注释中的一个,然后编写与该注释对应的代码。

一个例子是:

//loop though all the names from n to j - 1

除此之外,我无法想象为什么有人会在可以编写代码的时候浪费宝贵的时间来写评论。

我是对还是错?我错过了什么吗?我不知道还有哪些其他好的评论用例?

最佳答案

评论应该表达为什么你在做某事而不是你在做什么

https://stackoverflow.com/questions/2231830/

相关文章:

python - 在列表上迭代格式字符串

c# - 我应该使用 ToString() 还是 GetDateTimeFormats() 来格式化

sql - 总是在 SQL 中显示小数位?

netbeans - 更改netbeans中自动突出显示的变量名的突出显示颜色?

.net - 文化不可变对象(immutable对象) ToString()

perl - 在 Perl 中处理非常大的数字时,如何禁用科学记数法?

intellij-idea - 如何阻止 IntelliJ IDEA 从 .properties 文

javascript - 不允许在 textarea 中换行

r - 用 R 定义 Excel 的列宽

vim - 如何在 Vim 中插入对齐文本列所需的可变数量的空格?