成為卓越程式設計師的38項必修法則

12

|

第二章：保持門面

在類別宣告中，分組可以表示為：

class Example

{

public:

Example(); // 首先是存留期管理

~Example();

void doMostImportantThing(); // 這會開啟一個新的“段落”

void doSomethingRelated(); // 這裡的每一行都像是一個句子

void somethingDifferent(); // 這是另一個段落

void aRelatedThing();

private:

int privateStuffComesLast;

};

請優先編寫較短的程式碼區塊。不要在一個函式裡面寫入五個“段落”。請考慮將它分

成五個函式，並為它們選一個好名字。

一致性

不要過於重視排版樣式。選一個，並持續使用它就好。最好使用最適合你的語言的典型

表達風格。請遵循標準程式庫的風格。

使用與團隊的其他人相同的排版方式來編寫程式。不要因為你認為自己的風格比較漂亮

或比較好而使用它。如果你的專案沒有一致性，考慮制定

編程標準或風格指南

。它不

見得需要是冗長、嚴苛的文件，只要用一些大家認同的排版原則來凝聚團隊共識就可以

了。在這個情況下，編程標準必須是彼此認同的，而不是強迫彼此。[Page-12]

如果你使用的檔案的排版方式與專案其他檔案不同，請使用那個檔案裡面的排版格式。

確保整個團隊的 IDE 與原始碼編輯器都使用同樣的設定。設定相同的定位停駐點大小

（tab stop size）。設定完全相同的大括號位置及註解排列方式。設定相同的換行選項 ...