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

　　我要無辜的坦白說，您遇到標(biāo)題黨了。

　　沒有血案，但有些沖突。不是代碼bug，我要講注釋風(fēng)格。

　　這位看官，既然來了，且讀且評吧。故事是真實(shí)的，如有雷同純屬巧合。

　　事情是這樣的，有人離職，公司調(diào)我補(bǔ)缺。那個(gè)系統(tǒng)一直有個(gè)工程師在維護(hù)，參與該系統(tǒng)的新人來了又走，他始終泰若磐石。剛過去一個(gè)禮拜，我就心下竊吼：“TMD坑爹啊!”，也徹底體會(huì)到什么叫---絕對的權(quán)威、專家。該軟件系統(tǒng)，是公司發(fā)家的支柱產(chǎn)品，涉及十幾個(gè)國家x七八個(gè)機(jī)型，700+個(gè)文件(C語言，所有.c .h檔)，十幾萬行代碼，盡兩百個(gè)跨模塊全局變量，編譯條件成百上千......(好吧，這是找借口、吐槽的節(jié)奏)

　　盡管有名義上的交接，和幾次和聲細(xì)語的密切指導(dǎo)。但真正獨(dú)立展開工作時(shí)，許多小功能增刪改，我都要折騰個(gè)好幾天才能厘清代碼調(diào)用關(guān)系、算法原理，然后找到修改點(diǎn)謹(jǐn)慎細(xì)微龜速前行。進(jìn)度追蹤的人有的時(shí)候也催毛了，直接請專家大師出手，咔咔咔，不到半天就搞定了。當(dāng)然，前期我當(dāng)然盡量的”不恥上問”，但人嗎，總是有遇到被激發(fā)“骨氣”的時(shí)候。

　　這幾天，好不容易搞好一個(gè)全新的功能模塊，把代碼推送給他合并編譯。不曾想，出現(xiàn)了讓我泣血的一幕。

　　我眼睜睜地、眼睜睜看著她把我辛苦敲入的代碼注釋/**/通通換成//，一份精美的代碼，頓時(shí)成渣。

　　我詢問緣由，她的回答是: 當(dāng)代碼里面充滿注釋符號/**/時(shí)，她想要用/**/注釋整段代碼時(shí)，就會(huì)很麻煩。 我理解了，因?yàn)?**/不支持嵌套。比如下面這樣的語句是編譯不過的。

　　/*

　　a = b+c; /* 注釋 */

　　*/

　　我的手抬了抬，終究作罷。雖然我感覺到尊嚴(yán)被踐踏，心愛的作品被蹂躪，但我還是開始反思。

　　許多軟件規(guī)范、專家、有經(jīng)驗(yàn)的工程，都建議或要求注釋代碼最好使用 /**/，他們的理由大略如下:

　　1. “//” 的注釋的嚴(yán)密性不夠。 例如

　　// 注釋語句 ??/

　　a = b+c;

　　此時(shí)，a = b+c在一些編譯器不會(huì)被執(zhí)行。

　　因?yàn)?quot;??/"會(huì)被編譯器當(dāng)作 ，變成C語言的換行符。于是這段代碼等同于

　　// 注釋語句 a = b+c ;

　　就會(huì)被注釋掉。大家有興趣的，不妨去搜索一下"C語言 三字母詞"

　　當(dāng)然，哪怕沒有??/， 自己打盹碰到delete鍵也是會(huì)屏蔽掉a=b+c的

　　2. “//” 的注釋，是C++發(fā)展后才引進(jìn)的。 有些早期的C編譯器對這種注釋是不支持的。代碼要做到全平臺(tái)兼容，這點(diǎn)是必需要考慮的。

　　因此，老外定義的C語言軟件規(guī)范，無論是MISRA還是CMMI，一般都要求所有代碼注釋必須使用/**/。

　　君不見，那uCOS的最新版本源碼，所有注釋都是/**/。

　　君不見，那STM32的最新固件庫，洋洋灑灑幾十個(gè)文件，通篇皆沒有用到//。

　　正是基于這樣的理由，讓我的心中充滿了慍怒。但我仍然沒有當(dāng)場反駁她，因?yàn)檫@些理由還有些蒼白無力。

　　1. 當(dāng)時(shí)，那個(gè)什么三字母詞“??x”到底是什么我已經(jīng)忘了，沒法立刻做試驗(yàn)編譯給她看。

　　而且時(shí)候我里面作了編譯實(shí)驗(yàn)，得到的是

　　"filename.c", line xxxx: Warning: #2532-D: support for trigraphs is disabled xx代碼語句xx // ??/

　　trigraph金山詞霸---> [traigra:f]三字母詞

　　看吧，編譯器都警告了，默認(rèn)是不支持的。

　　2. 而且，所謂的//是C++的，早期的c編譯器不支持。

　　這點(diǎn)誰鳥啊，我們只要現(xiàn)在，只用最新版本的編譯器。

　　所以，我還要繼續(xù)思考。

　　我要維護(hù)這個(gè)傳統(tǒng)，為自己代言......