天天看點

關于代碼注釋的危害

關于代碼注釋的危害

在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技術學習提升大禮包!(含文檔、電子書、視訊等等)

繼續閱讀