一致性原則
// 或者/* */都可以，保持一致即可。
文件注釋
.h文件對所聲明的類的功能和用法作簡單說明，.cpp文件包含更多的實現細節。不要在頭文件和實現文件中簡單的復制注釋，那就失去了一半的意義。
函數注釋
頭文件中描述函數功能，定義處描述功能實現。
變量注釋
成員變量、全局變量都一樣，說明其用途即可。
注意拼寫和語法
錯誤的語法，錯誤的拼寫給他人帶來困惑與不快，寧愿不寫，不可亂寫。
中文還是英文
這個看個人喜好，如果英文不過關，就不要硬撐著。注釋的本質是幫助別人和幫助自己更好的理解代碼，不是炫耀英文或中文水平。
posted on 2011-01-25 18:29 孔雀 閱讀(2309) 評論(2) 編輯 收藏 引用 所屬分類: C/C++