2019獨角獸企業(yè)重金招聘Python工程師標(biāo)準(zhǔn)>>>

??????? 摘要：因工作忙，不少人只注重實現(xiàn)程序基本功能，而忽略編程規(guī)范，結(jié)果是寫的代碼很難讀懂，甚至連閱讀自己的代碼都十分困難，這造成時間浪費，做事效率降低。而高手寫出的代碼都易領(lǐng)會，我們?nèi)绾巫鲆材芟袼麄冞@樣呢？

??? “首先是為人編寫程序，其次才是計算機”，這是軟件開發(fā)的基本要點，軟件的生命周期貫穿于產(chǎn)品的開發(fā)、測試、生產(chǎn)、發(fā)布、用戶使用、版本升級和后期維護等長期過程中，只有易讀、易維護的軟件代碼才具有生命力。

????? 在實際的軟件開發(fā)過程中，可能是由于工作很忙的原因，很多開發(fā)人員只注重實現(xiàn)程序的基本功能，而忘記了編程規(guī)范，因此寫出來的代碼只能讓計算機看懂，人要看懂很不容易。更有甚者，有些項目組為了趕進度，明確要求組員以實現(xiàn)產(chǎn)品功能為主，代碼能夠運行起來就可以了。低要求產(chǎn)生低質(zhì)量的代碼，既然“上頭”都這樣要求了，那還有必要寫出“讓人能夠讀懂”的代碼嗎？

如果不為人編程，帶來的后果是？

??? 進度是趕上了，產(chǎn)品也交付出去了，一切看來是OK的，但問題也就來了。前方產(chǎn)品故障頻發(fā)，后方開發(fā)人員不停地?fù)浠稹＿@個時候，他們才發(fā)現(xiàn)之前別人寫的代碼很難讀懂，甚至連閱讀自己寫的代碼都十分的困難，真是悔不當(dāng)初。如果開始的時候能夠?qū)⒋a寫規(guī)范一點，文檔配備齊全一點，何至于此？

??? “好”的代碼和“不好”的代碼給人的感覺是千差萬別。當(dāng)我們看到優(yōu)美的代碼時，會有一種想繼續(xù)研究下去的欲望，甚至?xí)幸环N覺得很享受的感覺。相反，當(dāng)我們看到丑陋的代碼時，就會咬牙切齒，因為它不僅不利于閱讀，還會浪費我們很多時間，降低我們做事的效率。

一般說來，“好”的代碼和“不好”的代碼給我們的印象有如下幾種：

排版工整 VS 排版不工整

??? 我們打開一個代碼文件的時候，最先看到的就是其排版怎樣，這也是最直觀的感覺。當(dāng)代碼排版工整時，我們很容易找出其條理和邏輯，會很快理解其到底要實現(xiàn)什么功能；而排版不工整的時候，我們的眼睛會覺得很累，進而影響了我們的思維。

命名規(guī)范 VS 命名不規(guī)范

??? 在看完排版之后，我們就會看到每個函數(shù)和變量的命名。由于一般項目的代碼行數(shù)都比較多，我們不可能花很多時間去理解每個函數(shù)和變量到底是何用意，到底是拿來做什么的。這就要求我們在編碼的時候，使函數(shù)和變量的命名具有自說明性，讓它們自己告訴讀者是做什么用的，而不是要別人花大量時間去研讀后才能知道。這在一定程度上反映了開發(fā)人員的態(tài)度和專業(yè)化程度。

??? 例如，一個處理消息的函數(shù)，命名為ProcessMsg和FunctionA，哪個更好呢？顯然是前者。我們只要一看到其名字，就知道它是做什么用的。

??? 再如，有三個變量，命名為ReturnValue、MaxNum、SumOfTwoNum，我們就能一下子明白它們有何用途。第一個變量用于作為返回值，第二個變量用來存放最大數(shù)，第三個變量用來存放兩個數(shù)之和。這太明顯了，你都可以不用去問元芳，自己就能搞清楚。而如果同樣三個變量，命名為i、j、k，你就無法一眼看出它們到底有什么用，還要花大量的時間去閱讀代碼，甚至用幾個小時的時間，你還不知道它們有何用途。這時，你的老大來問你事情做得怎樣，你照實一說，他便說你無能。其實你是“啞巴吃黃連”，怪就怪別人沒有把代碼寫好。

注釋得當(dāng) VS 注釋不得當(dāng)

?? 閱讀代碼，我們還會注意到其是否有注釋，注釋多還是少。這也是很直觀的。

??? 如果代碼實現(xiàn)的功能較為復(fù)雜，那么添加注釋是必不可少的。在恰當(dāng)?shù)牡胤?#xff0c;使用恰當(dāng)?shù)淖⑨?#xff0c;能夠讓讀者覺得思路豁然開朗，他們會默默地在心里感激你。注釋過少或沒有注釋是不行的，就像我們吃飯一樣。如果一碗青菜里面什么也沒有，你會覺得很乏味，沒有食欲。如果放上一點辣椒醬，就會覺得食欲倍增。不管你信不信，反正我是信了。

?? 但是，注釋也不能過多，不能將有用的代碼掩蓋住了，不能夠喧賓奪主，讓真正實現(xiàn)功能的代碼成了陪襯。

為人編程：如何才能寫出讓“人”看得懂的好代碼

??? 那么，我們?nèi)绾螌懗鲎尅叭恕蹦軌蚩炊摹昂谩贝a呢？這個過程不能一蹴而就，要循序漸進，要從我做起，從身邊做起，不斷地提升個人編程的境界。

個人認(rèn)為可以考慮從以下幾個方面入手：

??? 第一，對新入職的員工進行軟件編程規(guī)范的培訓(xùn)。在剛開始工作中的時候，讓他們嚴(yán)格參照編程規(guī)范來編寫代碼。越早開展編程規(guī)范的訓(xùn)練，越是能夠早地養(yǎng)成編寫規(guī)范代碼的習(xí)慣，寫出的代碼也就越清晰。順便說句題外話，很多IT公司沒有這方面的意識，只顧對企業(yè)文化進行培訓(xùn)，以為這樣就能夠讓員工的忠誠度增加。實際上，這只是個異想天開的做法。

??? 第二，定期在項目組開展編程規(guī)范方面的主題討論，強化大家的意識。老員工寫出的代碼對新員工有示范的作用，如果老員工寫出的程序都是可讀性很差的，那么新員工會怎么想呢？他們又會怎么做呢？很多開發(fā)人員每天只顧埋頭苦干，卻忽略了一些最基本的東西，因此能力很難再次得到提升。在編寫完代碼之后，不要就以為事情做完了，還要編寫一些項目文檔，如詳細(xì)設(shè)計文檔、單元/集成測試文檔等。在這些文檔里面，把自己的思路寫清楚，方便以后自己或他人查閱起來能夠很快理解程序思路。

??? 第三，開發(fā)人員嚴(yán)格按照公司制定的編程規(guī)范來書寫代碼。變量如何命名？函數(shù)如何命名？注釋如何寫？代碼如何排版？這些都有嚴(yán)格的要求，作為一個合格的軟件開發(fā)工程師，編寫規(guī)范的代碼是基本的要求。當(dāng)我們閱讀到書寫優(yōu)美的代碼的時候，是不是心里面會覺得很爽？從某種程度上來說，代碼編寫的規(guī)范程度可以體現(xiàn)一個程序員的態(tài)度和專業(yè)素養(yǎng)。

??? 第四，項目組要嚴(yán)格執(zhí)行同行評審流程。大部分IT公司為了提高產(chǎn)品的質(zhì)量，都有一個叫做“同行評審”的流程，也就是讓項目組成員相互檢查各自的成果，大家相互學(xué)習(xí)、取長補短、共同提高。但是，可能是中國文化的影響，大家都比較顧及面子，因此不愿意將對他人真實的想法表達(dá)出來，也使得“同行評審”流于形式。當(dāng)然，也許你對別人的程序確實沒有意見，那就另當(dāng)別論了。對他人開誠布公地提意見并不是冒犯，而是大家相互學(xué)習(xí)的一種很好的方式。

??? 第五，最重要的是，個人要有編寫規(guī)范代碼的意識，要不斷地學(xué)習(xí)各種提高編程能力的技術(shù)。不管別人對你怎么說，如果你本人不想把程序?qū)懞?#xff0c;那么縱使萬般外力，又如何？程序員雖然工作很忙，但也要抽時間來學(xué)習(xí)新的技術(shù)，這樣才不會被新技術(shù)淘汰掉。

?? “長風(fēng)破浪會有時，直掛云帆濟滄海”，對于很多人來說，編寫出能夠讓計算機讀懂的程序就已經(jīng)足夠了，但如果想要成為一位優(yōu)秀的軟件開發(fā)工程師，那么就要力求寫出讓“人”能夠很容易看懂并領(lǐng)會的代碼。這是一個長期的過程，大家要有“萬里長征”的準(zhǔn)備，要有“愚公移山”的精神。

轉(zhuǎn)載于:https://my.oschina.net/chwencong/blog/301386

總結(jié)

以上是生活随笔為你收集整理的【转】首先为人编写程序，其次才是计算机的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。