<table class="docutils field-list" frame="void" rules="none"><col class="field-name"/><col class="field-body"/><tbody valign="top"><tr class="field-odd field"><th class="field-name">版本:</th><td class="field-body"><p class="first">3.133</p></td></tr><tr class="field-even field"><th class="field-name">原作者:</th><td class="field-body"><div class="first line-block"><div class="line">Benjy Weinberger</div><div class="line">Craig Silverstein</div><div class="line">Gregory Eitzmann</div><div class="line">Mark Mentovai</div><div class="line">Tashana Landray</div></div></td></tr><tr class="field-odd field"><th class="field-name">翻譯:</th><td class="field-body"><div class="first line-block"><div class="line"><a class="reference external" href="http://www.yulefox.com">YuleFox</a><span class="link-target"> [http://www.yulefox.com]</span></div><div class="line"><a class="reference external" href="http://yangyubo.com">brantyoung</a><span class="link-target"> [http://yangyubo.com]</span></div></div></td></tr><tr class="field-even field"><th class="field-name">項目主頁:</th><td class="field-body"><ul class="first last simple"><li><a class="reference external" href="http://google-styleguide.googlecode.com">Google Style Guide</a></li><li><a class="reference external" href="http://github.com/zh-google-styleguide/zh-google-styleguide">Google 開源項目風格指南 - 中文版</a></li></ul></td></tr></tbody></table> ## 0.1 譯者前言 Google 經常會發布一些開源項目, 意味著會接受來自其他代碼貢獻者的代碼. 但是如果代碼貢獻者的編程風格與 Google 的不一致, 會給代碼閱讀者和其他代碼提交這造成不小的困擾. Google 因此發布了這份自己的編程風格, 使所有提交代碼的人都能獲知 Google 的編程風格. 翻譯初衷: 規則的作用就是避免混亂. 但規則本身一定要權威, 有說服力, 并且是理性的. 我們所見過的大部分編程規范, 其內容或不夠嚴謹, 或闡述過于簡單, 或帶有一定的武斷性. Google 保持其一貫的嚴謹精神, 5 萬漢字的指南涉及廣泛, 論證嚴密. 我們翻譯該系列指南的主因也正是其嚴謹性. 嚴謹意味著指南的價值不僅僅局限于它羅列出的規范, 更具參考意義的是它為了列出規范而做的謹慎權衡過程. 指南不僅列出你要怎么做, 還告訴你為什么要這么做, 哪些情況下可以不這么做, 以及如何權衡其利弊. 其他團隊未必要完全遵照指南亦步亦趨, 如前面所說, 這份指南是 Google 根據自身實際情況打造的, 適用于其主導的開源項目. 其他團隊可以參照該指南, 或從中汲取靈感, 建立適合自身實際情況的規范. 我們在翻譯的過程中, 收獲頗多. 希望本系列指南中文版對你同樣能有所幫助. 我們翻譯時也是盡力保持嚴謹, 但水平所限, bug 在所難免. 有任何意見或建議, 可與我們取得聯系. 中文版和英文版一樣, 使用 `Artistic License/GPL` 開源許可. 中文版修訂歷史: - 2009-06 3.133 : YuleFox 的 1.0 版已經相當完善, 但原版在近一年的時間里, 其規范也發生了一些變化. > > brantyoung 與 YuleFox 一拍即合, 以項目的形式來延續中文版 : [Google 開源項目風格指南 - 中文版項目](http://github.com/brantyoung/zh-google-styleguide) [http://github.com/brantyoung/zh-google-styleguide]. > 主要變化是同步到 3.133 最新英文版本, 做部分勘誤和改善可讀性方面的修改, 并改進排版效果. brantyoung 重新翻修, YuleFox 做后續評審. - 2008-07 1.0 : 出自 [YuleFox 的 Blog](http://www.yulefox.com/?p=207) [http://www.yulefox.com/?p=207], 很多地方摘錄的也是該版本. ## 0.2 背景 C++ 是 Google 大部分開源項目的主要編程語言. 正如每個 C++ 程序員都知道的, C++ 有很多強大的特性, 但這種強大不可避免的導致它走向復雜，使代碼更容易產生 bug, 難以閱讀和維護. 本指南的目的是通過詳細闡述 C++ 注意事項來駕馭其復雜性. 這些規則在保證代碼易于管理的同時, 高效使用 C++ 的語言特性. _風格_, 亦被稱作可讀性, 也就是指導 C++ 編程的約定. 使用術語 “風格” 有些用詞不當, 因為這些習慣遠不止源代碼文件格式化這么簡單. 使代碼易于管理的方法之一是加強代碼一致性. 讓任何程序員都可以快速讀懂你的代碼這點非常重要. 保持統一編程風格并遵守約定意味著可以很容易根據 “模式匹配” 規則來推斷各種標識符的含義. 創建通用, 必需的習慣用語和模式可以使代碼更容易理解. 在一些情況下可能有充分的理由改變某些編程風格, 但我們還是應該遵循一致性原則，盡量不這么做. 本指南的另一個觀點是 C++ 特性的臃腫. C++ 是一門包含大量高級特性的龐大語言. 某些情況下, 我們會限制甚至禁止使用某些特性. 這么做是為了保持代碼清爽, 避免這些特性可能導致的各種問題. 指南中列舉了這類特性, 并解釋為什么這些特性被限制使用. Google 主導的開源項目均符合本指南的規定. 注意: 本指南并非 C++ 教程, 我們假定讀者已經對 C++ 非常熟悉.