Google C++ 命名約定

通用命名規則

函數命名, 變量命名, 文件命名要有描述性; 少用縮寫.

int price_count_reader;    // 無縮寫
int num_errors;            // "num" 是一個常見的寫法
int num_dns_connections;   // 人人都知道 "DNS" 是什麼
int n;                     // 毫無意義.
int nerr;                  // 含糊不清的縮寫.
int n_comp_conns;          // 含糊不清的縮寫.
int wgc_connections;       // 只有貴團隊知道是什麼意思.
int pc_reader;             // "pc" 有太多可能的解釋了.
int cstmr_id;              // 刪減了若干字母.

注意, 一些特定的廣爲人知的縮寫是允許的, 例如用 i 表示迭代變量和用 T 表示模板參數.

文件命名

文件名要全部小寫, 可以包含下劃線 () 或連字符 (-), 依照項目的約定. 如果沒有約定, 那麼 “” 更好.
可接受的文件命名示例:

my_useful_class.cc
my-useful-class.cc
myusefulclass.cc
myusefulclass_test.cc 

內聯函數必須放在 .h 文件中. 如果內聯函數比較短, 就直接放在 .h 中.

類型命名

類型名稱的每個單詞首字母均大寫, 不包含下劃線: MyExcitingClass, MyExcitingEnum.
說明
所有類型命名 —— 類, 結構體, 類型定義 (typedef), 枚舉, 類型模板參數
// 類和結構體

class UrlTable { ...
class UrlTableTester { ...
struct UrlTableProperties { ...
// 類型定義
typedef hash_map<UrlTableProperties *, string> PropertiesMap;
// using 別名
using PropertiesMap = hash_map<UrlTableProperties *, string>;
// 枚舉
enum UrlTableErrors { ...

變量命名

變量 (包括函數參數) 和數據成員名一律小寫, 單詞之間用下劃線連接. 類的成員變量以下劃線結尾, 但結構體的就不用, 如: a_local_variable, a_struct_data_member, a_class_data_member_.

普通變量命名
舉例:

string table_name;  // 好 - 用下劃線.
string tablename;   // 好 - 全小寫.
string tableName;  // 差 - 混合大小寫

類數據成員
不管是靜態的還是非靜態的, 類數據成員都可以和普通變量一樣, 但要接下劃線.

class TableInfo {
  ...
 private:
  string table_name_;  // 好 - 後加下劃線.
  string tablename_;   // 好.
  static Pool<TableInfo>* pool_;  // 好.
};

結構體變量
不管是靜態的還是非靜態的, 結構體數據成員都可以和普通變量一樣, 不用像類那樣接下劃線:

struct UrlTableProperties {
  string name;
  int num_entries;
  static Pool<UrlTableProperties>* pool;
};

常量命名

聲明爲 constexpr 或 const 的變量, 或在程序運行期間其值始終保持不變的, 命名時以 “k” 開頭, 大小寫混合. 例如:

const int kDaysInAWeek = 7;

函數命名

常規函數使用大小寫混合, 取值和設值函數則要求與變量名匹配: MyExcitingFunction(), MyExcitingMethod(), my_exciting_member_variable(), set_my_exciting_member_variable().
一般來說, 函數名的每個單詞首字母大寫 (即 “駝峯變量名” 或 “帕斯卡變量名”), 沒有下劃線. 對於首字母縮寫的單詞, 更傾向於將它們視作一個單詞進行首字母大寫 (例如, 寫作 StartRpc() 而非 StartRPC()).
AddTableEntry()
DeleteUrl()
OpenFileOrDie()
(同樣的命名規則同時適用於類作用域與命名空間作用域的常量, 因爲它們是作爲 API 的一部分暴露對外的, 因此應當讓它們看起來像是一個函數, 因爲在這時, 它們實際上是一個對象而非函數的這一事實對外不過是一個無關緊要的實現細節.)
取值和設值函數的命名與變量一致. 一般來說它們的名稱與實際的成員變量對應, 但並不強制要求. 例如 int count() 與 void set_count(int count).

命名空間命名

命名空間以小寫字母命名. 最高級命名空間的名字取決於項目名稱. 要注意避免嵌套命名空間的名字之間和常見的頂級命名空間的名字之間發生衝突.
頂級命名空間的名稱應當是項目名或者是該命名空間中的代碼所屬的團隊的名字. 命名空間中的代碼, 應當存放於和命名空間的名字匹配的文件夾或其子文件夾中.
注意 不使用縮寫作爲名稱 的規則同樣適用於命名空間. 命名空間中的代碼極少需要涉及命名空間的名稱, 因此沒有必要在命名空間中使用縮寫.
要避免嵌套的命名空間與常見的頂級命名空間發生名稱衝突. 由於名稱查找規則的存在, 命名空間之間的衝突完全有可能導致編譯失敗. 尤其是, 不要創建嵌套的 std 命名空間. 建議使用更獨特的項目標識符 (websearch::index, websearch::index_util) 而非常見的極易發生衝突的名稱 (比如 websearch::util).
對於 internal 命名空間, 要當心加入到同一 internal 命名空間的代碼之間發生衝突 (由於內部維護人員通常來自同一團隊, 因此常有可能導致衝突). 在這種情況下, 請使用文件名以使得內部名稱獨一無二 (例如對於 frobber.h, 使用 websearch::index::frobber_internal).

枚舉命名

枚舉的命名應當和 常量 或 宏 一致: kEnumName 或是 ENUM_NAME.
單獨的枚舉值應該優先採用 常量 的命名方式. 但 宏 方式的命名也可以接受. 枚舉名 UrlTableErrors(以及 AlternateUrlTableErrors) 是類型, 所以要用大小寫混合的方式.

enum UrlTableErrors {
    kOK = 0,
    kErrorOutOfMemory,
    kErrorMalformedInput,
};
enum AlternateUrlTableErrors {
    OK = 0,
    OUT_OF_MEMORY = 1,
    MALFORMED_INPUT = 2,
};

2009 年 1 月之前, 我們一直建議採用 宏 的方式命名枚舉值. 由於枚舉值和宏之間的命名衝突, 直接導致了很多問題. 由此, 這裏改爲優先選擇常量風格的命名方式. 新代碼應該儘可能優先使用常量風格. 但是老代碼沒必要切換到常量風格, 除非宏風格確實會產生編譯期問題.

宏命名

你並不打算 使用宏, 對吧? 如果你一定要用, 像這樣命名:

MY_MACRO_THAT_SCARES_SMALL_CHILDREN.

參考 預處理宏; 通常 不應該 使用宏. 如果不得不用, 其命名像枚舉命名一樣全部大寫, 使用下劃線:

#define ROUND(x) ...
#define PI_ROUNDED 3.0

命名規則的特例

如果你命名的實體與已有 C/C++ 實體相似, 可參考現有命名策略.
bigopen(): 函數名, 參照 open() 的形式
uint: typedef
bigpos: struct 或 class, 參照 pos 的形式
sparse_hash_map: STL 型實體; 參照 STL 命名約定
LONGLONG_MAX: 常量, 如同 INT_MAX