一線研發之聲 之 C代碼注釋引發的“血案”

　　我開始思考，還有什么強勁有力的理由，來支持我恪守的真理：c語言代碼注釋必須使用/**/.

　　有的!

　　倘若所有代碼里面的注釋用到/**/時，當你要注釋掉這段代碼時，如果不想忍受編譯器的嵌套報警，又懶得把一個個/**/換成//的話。那么你還有如下選擇。

　　1) 慎重思考下是否刪光這段代碼，如果還有些不舍，那就先"備份"(git推送)一下再刪光。因此，

　　理由一：使用/**/注釋代碼，會使軟件系統減少冗余的僵尸代碼，鼓勵程序員的程序備份行為。

　　2) 或者用編譯條件圈起來，如下。

　　#if (XXX_ENABLE)

　　func(a, b, c); /* 注釋 */

　　...... /* 注釋 */

　　#endif

　　那么你不得不考慮xxx的命名，如何更加一目了然，再寫點注釋什么的，表明對這段代碼“棄而不舍”的緣由。因此，

　　理由二：使用/**/注釋代碼，會鼓勵程序員刪除代碼時，三思而后行，并且注明舍棄的理由。

　　3) 當然，偷懶的人還是會用 #if 0 #endif圈起來， 如下，

　　#if 0

　　func(a, b, c); /* 注釋 */

　　...... /* 注釋 */

　　#endif

　　而且不會寫任何注釋表明刪除的理由。然而，“#if 0”是一個如此的醒目，很容易成為一個評估軟件質量、工作績效的搜索關鍵詞。從管理的角度，這個是可以量化的。因此，

　　理由三: 使用/**/注釋代碼，有利于公司進行軟件質量控管，對程序員績效考核。

　　這三個理由，足夠為自己代言嗎?