評論代碼或不評論代碼

Question

我曾在不同的公司工作，在每個地方人們對是否應該在代碼中包含評論有不同的意見。有人說他們不應該這樣做，因爲程序員的代碼應該足夠簡單以便理解，因此應該是自我評論。他們進一步爭辯說，因爲代碼經常發生變化，開發人員並不總是勤勉地更新註釋和代碼，註釋很快就會過時並因此變得具有誤導性。另一組說，代碼的功能是用技術術語來描述系統的功能，但它並不總是描述代碼的商業原因，因此註釋對於給出上下文碼。我傾向於傾向於以前的觀點。我想知道社區的觀點是什麼。請分享你的想法。

感謝，

薩欽

Answer 1

我同意你的看法。應該在驗收測試中捕獲業務原因，或者如果您的類型系統足夠強大，可以直接在類型系統中編譯器進行機械檢查。

與商業規則一樣重要的東西肯定是而不是屬於註釋，它既不被檢查也不被執行也不被測試。