命名

對于易維護的代碼而言，命名規(guī)則非常重要。Objective-C 的方法名往往十分長，但代碼塊讀起來就像散文一樣，不需要太多的代碼注釋。

當(dāng)編寫純粹的 Objective-C 代碼時，我們基本遵守標(biāo)準(zhǔn)的 Objective-C naming rules <http://developer.apple.com/documentation/Cocoa/Conceptual/CodingGuidelines/CodingGuidelines.html>_，這些命名規(guī)則可能與 C++ 風(fēng)格指南中的大相徑庭。例如，Google 的 C++ 風(fēng)格指南中推薦使用下劃線分隔的單詞作為變量名，而(蘋果的)風(fēng)格指南則使用駝峰命名法，這在 Objective-C 社區(qū)中非常普遍。

任何的類、類別、方法以及變量的名字中都使用全大寫的 首字母縮寫 <http://en.wikipedia.org/wiki/Initialism>_。這遵守了蘋果的標(biāo)準(zhǔn)命名方式，如 URL、TIFF 以及 EXIF。

當(dāng)編寫 Objective-C++ 代碼時，事情就不這么簡單了。許多項目需要實現(xiàn)跨平臺的 C++ API，并混合一些 Objective-C、Cocoa 代碼，或者直接以 C++ 為后端，前端用本地 Cocoa 代碼。這就導(dǎo)致了兩種命名方式直接不統(tǒng)一。

我們的解決方案是：編碼風(fēng)格取決于方法/函數(shù)以哪種語言實現(xiàn)。如果在一個 @implementation 語句中，就使用 Objective-C 的風(fēng)格。如果實現(xiàn)一個 C++ 的類，就使用 C++ 的風(fēng)格。這樣避免了一個函數(shù)里面實例變量和局部變量命名規(guī)則混亂，嚴(yán)重影響可讀性。

文件名

Tip
    文件名須反映出其實現(xiàn)了什么類 -- 包括大小寫。遵循你所參與項目的約定。

文件的擴展名應(yīng)該如下：

類別的文件名應(yīng)該包含被擴展的類名，如：GTMNSString+Utils.h 或GTMNSTextView+Autocomplete.h。

Objective-C++

Tip
    源代碼文件內(nèi)，Ojbective-C++ 代碼遵循你正在實現(xiàn)的函數(shù)/方法的風(fēng)格。

為了最小化 Cocoa/Objective-C 與 C++ 之間命名風(fēng)格的沖突，根據(jù)待實現(xiàn)的函數(shù)/方法選擇編碼風(fēng)格。實現(xiàn) @implementation 語句塊時，使用 Objective-C 的命名規(guī)則；如果實現(xiàn)一個 C++ 的類，就使用 C++ 命名規(guī)則。

    // file: cross_platform_header.h

    class CrossPlatformAPI {
     public:
      ...
      int DoSomethingPlatformSpecific();  // impl on each platform
     private:
      int an_instance_var_;
    };

    // file: mac_implementation.mm
    #include "cross_platform_header.h"

    // A typical Objective-C class, using Objective-C naming.
    @interface MyDelegate : NSObject {
     @private
      int instanceVar_;
      CrossPlatformAPI* backEndObject_;
    }
    - (void)respondToSomething:(id)something;
    @end
    @implementation MyDelegate
    - (void)respondToSomething:(id)something {
      // bridge from Cocoa through our C++ backend
      instanceVar_ = backEndObject->DoSomethingPlatformSpecific();
      NSString* tempString = [NSString stringWithInt:instanceVar_];
      NSLog(@"%@", tempString);
    }
    @end

    // The platform-specific implementation of the C++ class, using
    // C++ naming.
    int CrossPlatformAPI::DoSomethingPlatformSpecific() {
      NSString* temp_string = [NSString stringWithInt:an_instance_var_];
      NSLog(@"%@", temp_string);
      return [temp_string intValue];
    }

類名

Tip
    類名（以及類別、協(xié)議名）應(yīng)首字母大寫，并以駝峰格式分割單詞。

應(yīng)用層 的代碼，應(yīng)該盡量避免不必要的前綴。為每個類都添加相同的前綴無助于可讀性。當(dāng)編寫的代碼期望在不同應(yīng)用程序間復(fù)用時，應(yīng)使用前綴（如：GTMSendMessage）。

類別名

Tip
    類別名應(yīng)該有兩三個字母的前綴以表示類別是項目的一部分或者該類別是通用的。類別名應(yīng)該包含它所擴展的類的名字。

比如我們要基于 NSString 創(chuàng)建一個用于解析的類別，我們將把類別放在一個名為 GTMNSString+Parsing.h 的文件中。類別本身命名為 GTMStringParsingAdditions （是的，我們知道類別名和文件名不一樣，但是這個文件中可能存在多個不同的與解析有關(guān)類別）。類別中的方法應(yīng)該以 gtm_myCategoryMethodOnAString: 為前綴以避免命名沖突，因為 Objective-C 只有一個名字空間。如果代碼不會分享出去，也不會運行在不同的地址空間中，方法名字就不那么重要了。

類名與包含類別名的括號之間，應(yīng)該以一個空格分隔。

Objective-C 方法名

Tip
    方法名應(yīng)該以小寫字母開頭，并混合駝峰格式。每個具名參數(shù)也應(yīng)該以小寫字母開頭。

方法名應(yīng)盡量讀起來就像句子，這表示你應(yīng)該選擇與方法名連在一起讀起來通順的參數(shù)名。（例如，convertPoint:fromRect: 或 replaceCharactersInRange:withString:）。詳情參見 Apple’s Guide to Naming Methods <http://developer.apple.com/documentation/Cocoa/Conceptual/CodingGuidelines/Articles/NamingMethods.html>_。

訪問器方法應(yīng)該與他們 要獲取的 成員變量的名字一樣，但不應(yīng)該以get作為前綴。例如：

    - (id)getDelegate;  // AVOID
    - (id)delegate;     // GOOD

這僅限于 Objective-C 的方法名。C++ 的方法與函數(shù)的命名規(guī)則應(yīng)該遵從 C++ 風(fēng)格指南中的規(guī)則。

變量名

Tip
    變量名應(yīng)該以小寫字母開頭，并使用駝峰格式。類的成員變量應(yīng)該以下劃線作為后綴。例如：``myLocalVariable``、``myInstanceVariable_``。如果不能使用 Objective-C 2.0 的 ``@property``，使用 KVO/KVC 綁定的成員變量可以以一個下劃線作為前綴。

普通變量名

對于靜態(tài)的屬性（int 或指針），不要使用匈牙利命名法。盡量為變量起一個描述性的名字。不要擔(dān)心浪費列寬，因為讓新的代碼閱讀者立即理解你的代碼更重要。例如：

• 錯誤的命名：

        int w;
        int nerr;
        int nCompConns;
        tix = [[NSMutableArray alloc] init];
        obj = [someObject object];
        p = [network port];

• 正確的命名：

        int numErrors;
        int numCompletedConnections;
        tickets = [[NSMutableArray alloc] init];
        userInfo = [someObject object];
        port = [network port];

實例變量

實例變量應(yīng)該混合大小寫，并以下劃線作為后綴，如 usernameTextField_。然而，如果不能使用 Objective-C 2.0（操作系統(tǒng)版本的限制），并且使用了 KVO/KVC 綁定成員變量時，我們允許例外（譯者注： KVO=Key Value Observing，KVC=Key Value Coding）。這種情況下，可以以一個下劃線作為成員變量名字的前綴，這是蘋果所接受的鍵/值命名慣例。如果可以使用 Objective-C 2.0，@property 以及 @synthesize 提供了遵從這一命名規(guī)則的解決方案。

常量

常量名（如宏定義、枚舉、靜態(tài)局部變量等）應(yīng)該以小寫字母 k 開頭，使用駝峰格式分隔單詞，如：kInvalidHandle，kWritePerm。