為何我喜愛讀他人的代碼，而你也應該去喜愛它
原作者 : Alan Skorkin
翻 譯：Xguru
這讓我想到很多程序員討厭去閱讀代碼，來接受它吧。人人都喜歡編寫代碼--寫代碼是很有樂趣的事。但閱讀代碼卻是一種困難的工作。它不僅僅繁重，而且很無聊，讓我們面對這個事實，任何不是自己寫的代碼都是差勁的（嘿嘿，雖然我們沒有這樣說過，但是其實我們都是這樣想
的）。甚至當你寫完代碼后的僅僅幾個小時之后，你的那些代碼就開始變得越來越爛了，時間一長，你就會把它當作看起來的那種差勁作品。
所以，你又何必要去花費時間來審視別人蹩腳的代碼呢，這段時間你完全可以用來
自己去寫一些非常優秀的代碼，為什么不這樣嘗試一下，把自己寫好的代碼放上幾個小時再回頭看看，它是否依舊非常優秀呢？如果你不站在前輩們的肩膀上，你將沒有可能成一個為技藝精湛的大師。其中一種途徑就是親自找到一個大師，讓他把他所有的知識全部傳授給你--當然這是有可能的，雖然可能性不高，你必須非常走運才能獲到這種機會。然而你可以不用想著去碰運氣， 我們很幸運的處在這樣的一個職業里--大師們的經驗和知識都在那里等著我們去吸收，這些都蘊涵在他們所寫 的代碼里。你所要做的事就是去閱讀它，當然它可能會比找一個人坐在你旁邊向你解釋這些多占用一點時間，但是這是實現起來可能性較高，透視全局地思考下，若想成為優秀的木匠，你就必需觀察大量的擁有優良結構的家具。
我喜愛閱讀代碼，我的直覺告訴我，你也將會從中受益匪淺，是的，它的確可能是無聊、令人惱火的的事，
但是它所產生回報非常值得你去努力。考慮這個，如果你想成為一個優秀的代碼寫手，你是否專門將注意力集中在編寫代碼上？你可能嘗試過，但是你無法單單靠寫代碼走得更遠。這是個普遍公認的事實，大多數卓越的寫手都是如饑似渴的閱讀者。在你希望去寫些體面點的東西之前，你需要閱讀其他卓越的寫手的作品，吸收不
同的風格，看看在你之前別人有了怎么樣的嘗試。從而培養你自己的創造性。你的知識會慢慢增長，最后你自己寫的東西會顯得成熟，你將慢慢找到編碼的"感覺"，編寫代碼也是同樣如此，如果你從來沒有閱讀過其他卓越的代碼，
你又憑什么指望能寫出一些優雅的代碼？答案就是別指望這碼事了。對于優秀的程序員來說，閱讀卓越的代碼就像作家需要閱讀卓越的書籍一樣重要。
盡管所有的這些都不容易讓人信服，但是有一個事實是毋庸置疑的--作為一個專業的開發者，擅長閱讀代碼能夠對你的生存十分重要。如今任何正式的項目都是一個團隊的 努力，所以這將有大量的代碼不是你所提交，但是你又不得不要與其工作、修改和擴展它
。因此，閱讀代碼可能將是你所擁有的最常用到并且最有用的技能；你最好盡快咬緊牙關去掌握它。
我無法告訴你我見過多少次這樣的情形：程序員在陌生的代碼里上下滾動屏幕，幾分鐘以后，臉上就出現了郁悶的表情。然后他們就宣布這代碼就是不具備可讀性的廢物，為何要在這上面浪費時間呢；我們只能用其他的某種方法去解決這個問題。我不確定他們期待什么，是靠潛移默化就能理解代碼的意義？或者是就靠聚精會神地盯著這些代碼，就期待能獲得啟迪？你不應該只長時間的注視著代碼，你需要理解它并將其為己所用。這里有一些我喜歡使用的技巧，它并不是一個詳盡的清單，但是我發現這些方法特別有用。
1. 試著去編譯和運行它。這通常是一個簡單的處理步驟，比如當你尋找工作性的代碼（與隨意的編碼相反）。然而這也并非總是如此，你能通過將其構建和執 行的過程中學習到代碼里很多高層的結構組織。在工作代碼的主題中，你是否熟悉如何構建你當前的項目？項目的構建通常是復雜的，但是能夠通過一點點地了解構建過程可執行碼是如何產生的，可以讓你獲得很多的體會。
2. 不要只著眼于細枝末節。第一件事你需要做的，就是在你所讀的代碼結構和風格中找點感覺，開始瀏覽和試著弄明白各個代碼段想要做些什么。這會讓你熟悉整個代碼庫的高層的結構，同時也給你正在處理的代碼（無論是良好分解的、或者是意大利面條式【譯注：形容代碼混亂難以梳理】的等等）一些構思，這是你找到問題切入點的時候（任何發生的事，主函數、小型服務程序、 控制器等），觀察代碼是如何從這里分支出去的。但是不要花費大量的時間在這個上面，隨著你對代碼有更深入的了解，你可以隨時返回到這個步驟。
3. 確認你了解了它所有的結構。除非碰巧你是在編程語言上的首席專家，否則這里可能有些它讓你不了解的行為。當你從較高層級的俯覽過其代碼時，記錄下你不可能不熟悉的結構。如果記錄的東西非常多的話，你的下一步就很明顯了。如果你對逐句的代碼是如何工作不怎么了解的話，就不要走得太遠。盡管只有幾個結構你不太熟悉，如果你去仔細探究它們的話，可能會為你帶來良好的構思。你現在也是正在探索以前你所使用的編程語言中一些不了解的東西，我很樂意為此花費幾個小時去閱讀代碼。
4. 現在你獲取到了大多數結構的優良構思，是該任意來幾個的深入實踐的時候了。像步驟2一樣，開始在代碼里漫游，但是這次，從中挑選出任意幾個函數或者類，開始一行一行地進行分析。這是艱苦工作的開始，但是同時也是
你獲得主要成果的開始。這里的構思就形成了你所看的這個代碼庫的觀念模式。也不要在這上面花費太多的時間，但是在繼續前進之前，試著深刻地吸收一些內容豐富的模塊。這是你能夠在了解更多背景下反復地返回、并每次都能從中得到更多的東西的另外一個步驟。
5. 毋庸置疑的事就是你在前幾個步驟中對某些方面會產生疑惑，所以，這是你最佳的時間去運行和閱讀一些測試了。當你在測試中增加對代碼的了解的同時，將有或多或少潛在的麻煩在潛伏著你。我經常會感到驚訝，當閱讀和了解代碼時，開發者竟然會忽略其中寫得很好很全面的一個測試套件。但是有時候，它沒有提供測試用例。
6. 你說它沒有測試用例么，聽起來像是該寫些東西的最好時機了。這是很有益的事， 這會有助于你自己的理解，改善代碼庫、閱讀的時候同時寫些代碼，這是給你自己找點事干最好的機會。即使它已經提供有測試案例了，但是你總是能寫出讓你更受益的東西。測試代碼經常需要換個不同的角度去思考，在你將其弄清楚之前，有些概念會躲避著你。
7. 抽取少量稀奇有趣的代碼，將其寫成獨立的程序。我發現這是在閱讀代碼過程中有趣的練習，即使改變了你的計劃進度。盡管你不了解代碼底層的細節，但是你可能會對代碼在高層的行為有了一些思路。為什么不抽取一些特
殊的函數將其轉變成一個獨立的程序呢？當你讓一小塊代碼獨 立地執行時，將更易于調試，而且這又允許你有了額外的步驟去獲， 去你正在研究的代碼有了得更多見解。
8. 這代碼是骯臟和有壞味的嗎？那么為何不將其重構呢。我不是建議你重寫整個代碼庫， 但是即使對一小部分的代碼進行重構也能使你的理解上一個層次。開始將你所理解函數改成獨立的函數。在你了解之前，原有的規模巨大的函數看起來容易做到的，
你能在大腦里修改它。重構允許你將代碼變成你自己東西，而無需將其完全重寫。它能為你提 供優秀的測試用例，但是即使你沒有這個，僅僅是測試并且只是講你確認了的函數提取出來。雖然這個測試看起來完全是不足夠的 --作為一個開發者，學著相信你自己的技術。有時候你只好需要這樣去做。
9. 如果看起來很無助的話，那就為自己找個同伴一起閱讀代碼。你可能不是能在讀這份代碼里受益唯一的人，所以去尋找一個其他的人并試著一起閱讀。然而不要去找那些專家，他們會在高的層次向你解釋這一切，你會錯過當你拾起代碼自己去經歷時所能得到其中所有微妙的地方。如果不見效的話，你就不要再去強求，有時候最好的辦法就是你去提問，問你的同僚。或者你是在讀開源代碼的話，試著去在互聯網上尋求他人的幫助。但是請記住，這是最后一步，不是第一步。
如果時間所迫，你需要適當地加快速度去了解一些代碼時，只能選上面的一個步驟的話，我會選擇重構
（第8步）。你不能很快地將其了解清楚，但是如果你做了這個工作的話，你將會牢牢地掌握它。沒關系，你需要將這句話記在心里：如果你是剛接觸一個重要的代碼庫，
你不可能立刻弄懂它們，甚至不能快速地弄懂它們。這將耗費數天、數周或者數月的不懈的努力--只要去接受它就行了。如果有專家加盟的話你也不能顯著的減少時間 (這是我下個教學系列的文章 將討論的）。然而無論如何，如果你在讀代碼（還有寫代碼）是有耐心的、有條不紊的，你最后總能變得通曉項目所有的方面，并且當涉及到代碼庫的時候，你會成為能夠勝任他人難以企及工作的人（go-to man）。或者你會選擇成為逃避閱讀代碼、總是找人向你解釋問題的家伙。我知道我會選擇哪一個的。
尋找代碼閱讀機會--而不要去逃避它們
我們喜歡編寫新的代碼,一個誘人原因就是我們能用它恰到好處地處理問題。好吧，可能這次不是，但是下次一定就是了。事實上，你一直在改進你的技藝，但你永遠不可能恰到好處的處理問題。這就是寫新代碼一直存在的價值的原因，你能夠獲得鍛煉并且磨礪你的技巧，其實閱讀和把玩別人所寫代碼也有同樣的（如果沒有更多的話）價值。你不僅僅能從中得到一些有價值的技術知識，還同樣經常能獲得一些領域知識（歸根結底，代碼是文檔的最終的形式），這仍然是很有價值的東西。
即使代碼使用奇怪的方式所編寫，不經過轉換加密的話，都可能是有價值的。你懂我所說的那類代碼，它看起來是加密混淆過了的，但是它并不是有意而為之的（由于某種原因，Perl經常就是這種代碼?），無論何時我見到這樣的代碼，我就會想到了這個方法。把這東西想象成是只能經過解密破譯后你才能從中有所學的東西。是的，這是很痛苦的事，但是請你容許它，有時候你也會因為某種神秘瑣碎的原因，寫出這種看起來像被混淆了的代碼（不要否認它，你知道這是真的）。好了，如果你如此這般的投入了時間去閱讀代碼，你更可能最后能夠寫出這種代碼--并不是意味著你一定要將其寫出、而是你將擁有寫出它的能力。最后說一句，態度決定一切，如果你把閱讀代碼視作乏味無聊的事，它就會變得乏味無聊，你就會去逃避它，但是如果你選擇將其看作一次機遇的話--那么好事就要降臨了。
by XGuru
is licensed under a Creative
Commons 署
名-非商業性使用-相同方式共享 2.5 中國大陸
License. 原文請
看這里。
Thanks to bearice for debugging.