关于代码注释的危害
在github的LTP项目(一个linux内核测试项目)的文档看到这么一句话不很理解,关于代码注释的危害.
我印象中不是鼓励大家进行代码注释嘛?这里面说Comments more harm than good 。
原因 :comments and actual implementation were drifting slowly apart
结果:API misuses and hard to find bugs.
通俗的讲,就是如果你给了错误注释,注释的内容与实际代码所做的内容相差甚远,会误导到其他使用到这段代码的人。
错误的文档往往比没有文档跟糟糕,因为这会把使用者引向错误的导向。
1000道程序员常见问题解析是最近新整理的一个专栏,欢迎大家提供问题与思路。
所有问题、思路、答案将整理在公众号,大家可以扫码关注一下,相互交流学习。
关注即可免费领取一份2020技术学习提升大礼包!(含文档、电子书、视频等等)