Google C++ 風格指南核心規範摘要

Google C++ Style Guide 重點整理

一、頭文件規範

1. 宏定義保護

項目 foo 中 foo/src/bar/baz.h 使用：

#ifndef FOO_BAR_BAZ_H_
#define FOO_BAR_BAZ_H_
// ...
#endif  // FOO_BAR_BAZ_H_

2. 條件編譯

// 平台差異
#ifdef _WIN32
#define MYTYPE long
#else
#define MYTYPE float
#endif

// 調試開關
#ifdef DEBUG
    printf("device_open(%p)\n", file);
#endif
// 需配合 -DDEBUG 編譯選項

3. 內聯函數

不內聯超過 10 行的函數。

4. 函數參數順序

輸入參數在前，輸出參數在後。

二、其他核心規範（節選）

• 命名：類/結構體 PascalCase，變數/函數 snake_case，常數 kConstantName，宏 ALL_CAPS
• 縮排：2 空格，不使用 Tab
• 大括號：K&R 風格（左大括號不換行）
• const：盡可能使用 const、constexpr
• 智慧指標：優先 std::unique_ptr、std::shared_ptr，避免裸 new/delete
• 移動語意：C++11 後正確實現移動建構/賦值
• 異常：Google 內部禁用異常，但開源專案可自行決定
• 命名空間：鼓勵使用，避免全域汙染

三、官方資源

完整指南：https://google.github.io/styleguide/cppguide.html

自動格式化工具：clang-format 配合 .clang-format 設定檔（Google 風格預設）。