讓我們看一些基本的程式設計技巧:
- 儘量保持方法簡短
- 永遠永遠不要把同一個變數用於多個不同的目的
- 使用自描述的變數名和方法名
- 儘可能的把變數定義在靠近使用它的地方
- 拒絕神祕數字
- 友好的對待你的語言
- 不要逆常規而行
- 警惕過早優化
- 積極重構測試過的程式
- 不要過度沉迷於技巧
- 通過習例學習新知
現在,讓我們把每個小點展開來詳細講一下。
1. 儘量保持方法簡短
儘管很多人都遵循這個規則,但它仍然非常的重要。你寫的方法要始終能在一個螢幕裡放得下。如果你需要去滾動螢幕,這會分散你的注意力,而且你看不到整個的上下文。最佳長度是5-20行,這根據你的情況而定。當然,getters/setters 通常是一行程式碼的方法,但與其說它們是真正的方法,不如說它們只是存取工具。
2. 永遠永遠不要把同一個變數用於多個不同的目的
一個變數應該始終只為一個目的服務。通過使變數常量化(C++裡的const, Java裡的final),使得編譯器能夠優化編譯,而且使你的程式碼醒目表達這個變數是不能改變的,你的程式的可讀性會變得更好。
3. 使用自描述的變數名和方法名
你的程式碼應該,對於任何人來說,只要看一眼就能知道是幹嘛的。儘量不要用簡寫方式,除非有特殊的習慣,就像下面的:
src - source pos - position prev - previous
如果你認為描述性的名稱並不是那麼有價值,請對比一下n, ns, nsisd 和numTeamMembers, seatCount, numSeatsInStadium。
4. 儘可能的把變數定義在靠近使用它的地方
蓋房子時,你可不希望把錘子放到別人的院子裡。你希望把它們放的離手頭越近越好。定義變數也是同樣的道理。
int foo = 3; int bar = 5; // 一大段使用“bar”的程式碼, // 但沒用到“foo” // ... baz(foo);
這段程式碼可以簡單的重構成
int bar = 5; // 一大段使用“bar”的程式碼, // 但沒用到“foo” // ... int foo = 3; baz(foo);
當你把變數的宣告和第一次用到它的地方間隔太遠時(距離超過一個螢幕),這確實會成為一個問題。記住上下文關係會變得困難,你需要滾動螢幕去找哪來的這個變數。
5. 拒絕神祕數字
當你要把什麼東西跟一個常量值做比較時,記得把這個值定義成常量。沒有什麼會比去猜測你的同事寫的這樣的程式碼更讓人頭疼的事了:
il < 4384
換個形式感覺如何?
inputLength < MAX_INPUT_LENGTH
6. 友好的對待你的語言
學習新語言是一種很有樂趣的事情,你能學到一種新的完成任務的途徑。當一個對一種語言已經很專業的人去學習另一種語言時,會出現一種很大的負面效應。比如說你是一個Java開發者,試圖去學習Ruby。你應該學會用Ruby的方式解決問題,而不是沿用Java的解決問題的思想。
當你需要重複5遍”Hello world!“時,在Java裡,你可能會這樣做:
for (int i = 0; i < 5; i++) { System.out.println("Hello world!"); }
在Ruby裡,你也許會禁不住這樣寫:
for i in (0..5) puts "Hello world!" end
這樣看起來沒問題,但有一個更好的方式:
5.times { puts "Hello world!" }
7. 不要逆常規而行
每種語言都有自己不同的習俗約定。一般來說,人們聽的最多的是Java的編碼規範。讓我們看看其中的一些習俗規範:
- 方法名應該小寫字母開頭,其後用字母大寫的單詞連線(veryLongVariableName)
- 類名應該都使用首字母大寫的單詞連線而成
- 常量名應該全部大寫,用下劃線連線(MY_CONSTANT)
- 左大括號應該跟 if 語句在同一行
只有在有必要的理由時才去打破這些常規,不要輕易的因為你不高興就違反它。如果你只是在團隊裡改變一些這樣的習慣,那也沒問題,但當把你程式碼拿出來和其他的沒有這些思想準備的程式設計師共享時,問題就會來了。
8. 警惕過早優化
過早優化是所有問題的根源,至少電視上是這麼說的 … 你第一應該關心的事情是寫出易於理解的程式碼。起初寫的程式不要求快。除非你的程式很慢,否則談優化都是為時太早。如果你想優化什麼東西,你首先需要知道問題出在哪。這就是我們需要profilers這個工具的原因。
在沒有知道問題在哪的情況下試圖對程式進行優化,其結果必然是把程式能壞,至少你的程式碼會喪失可讀性。如果你覺得有些地方很慢,不要盲目的重寫程式碼,你應先找到慢的證據。
不要傻乎乎的去解決根本不存在的問題。
9. 積極重構測試過的程式
沒有任何東西會是完美的。即使你感覺你真正寫出了一段完美的程式碼,幾個月後回頭再看看,你可能會驚訝道”怎麼會這樣傻?“
改程式序的一個好方法就是重構,但要等程式測試通過之後。你首先要確保程式是好的可執行的,你可以通過自動化測試或手工測試完成這個工作。
之初,你需要的是程式可用。不要期望在第一次就寫出完美的程式,你只需要把它寫出來,可用。然後重構它,使之完美。對於你們當中知道測試驅動開發(TDD)的人來說,對這個會很熟悉。這裡的關鍵就在於你要習慣於重構這種事情。如果你使用的是像IntelliJ IDEA這樣強大的整合開發工具的話,重構的工作會變得簡單的多。
重構之後,你也許會弄出一些Bug,導致某些功能出問題。這就是為什麼說寫自動化測試的原因。不論何時重構後,只要執行一下所有的測試用例,你就能準確的知道什麼地方出了問題。
10. 不要過度沉迷於技巧
當我第一次讀到有關設計模式的知識時,我覺得我找到了聖盃。這些精心設計的思想作用顯著,它能使你的設計易於理解,因為你可以簡單的說”我使用的是‘觀察器模式’“,而不用從頭到尾的解釋一遍。那麼,有問題嗎?一切看起來都這麼自然、簡單,你開始不論在哪都使用設計模式。為什麼不把這個類做成singleton呢?幹嘛不去再建立一些工廠類呢?
於是一個80行就能寫完的指令碼,你最終使用了10個類,15個介面,外加一大堆正規化和標記符。97%的程式碼不做任何事情。設計模式是一種十分有用的用來簡化你的設計的工具,但這不意味著你該在所有能用到的地方都用它。你應該用它們,但不能濫用。
11. 通過習例學習新知
程式設計是一種學習新知的過程。當你學到了新的程式庫或新語言,你可能會迫不及待的丟掉舊的程式碼,用你新學到的東西重新寫一遍。有很多的理由都能說明你不該這麼做。
往現有的應用裡增加新的類庫或框架同屬於這種情況。就說你寫了一個Javascript的web應用,期間,你發現了jQuery。現在你突然急切的想丟到你的Javascript程式,重新用jQuery寫,儘管你還從來沒用過它。
最好的方式是你先用jQuery寫一些簡單的例子,通過這種方式把你在應用裡將要用到的知識都學會。需要AJAX?在你的專案之外做一些小例子,當完全弄懂了後,丟掉例子,應用到你的產品裡。
如果你非常關注程式設計技術,我強烈的推薦你閱讀Steve McConnell寫的《程式碼大全》 一書。它會永遠的改變你對程式設計的認識。:)
相關閱讀
評論(1)