Google开源项目C++风格指南.doc

Google 开源项目C++ 风格指南 0. 扉页 0.1 译者前言 0.2 背景 1. 头文件 1.1. Self-contained 头文件 1.2. #define 保护 1.3. 前置声明 1.4. 内联函数 1.5.?#include?的路径及顺序 译者 (YuleFox) 笔记 译者（acgtyrant）笔记 2. 作用域 2.1. 名字空间 2.1.1. 匿名名字空间 2.1.2. 具名的名字空间 2.2. 嵌套类 2.3. 非成员函数、静态成员函数和全局函数 2.4. 局部变量 2.5. 静态和全局变量 译者 (YuleFox) 笔记 译者（acgtyrant）笔记 3. 类 3.1. 构造函数的职责 3.2. 初始化 3.3. 显式构造函数 3.4. 可拷贝类型和可移动类型 3.5. 委派和继承构造函数 3.6. 结构体 VS. 类 3.7. 继承 3.8. 多重继承 3.9. 接口 3.10. 运算符重载 3.11. 存取控制 3.11. 声明顺序 3.12. 编写简短函数 译者 (YuleFox) 笔记 4. 来自 Google 的奇技 4.1. 所有权与智能指针 4.2. cpplint 译者（acgtyrant）笔记 5. 其他 C++ 特性 5.1. 引用参数 5.2. 右值引用 5.3. 函数重载 5.4. 缺省参数 5.5. 变长数组和 alloca() 5.6. 友元 5.7. 异常 5.8. 运行时类型识别 5.9. 类型转换 5.10. 流 5.11. 前置自增和自减 5.12.?const?用法 5.13.?constexpr?用法 5.14. 整型 5.15. 64 位下的可移植性 5.16. 预处理宏 5.17. 0,?nullptr?和?NULL 5.18. sizeof 5.19. auto 5.20. 列表初始化 5.21. Lambda 表达式 5.22. 模板元编程 5.23. Boost 库 5.24. C++11 译者（acgtyrant）笔记 6. 命名约定 6.1. 通用命名规则 6.2. 文件命名 6.3. 类型命名 6.4. 变量命名 6.5. 常量命名 6.6. 函数命名 6.7. 名字空间命名 6.8. 枚举命名 6.9. 宏命名 6.10. 命名规则的特例 译者（acgtyrant）笔记 7. 注释 7.1. 注释风格 7.2. 文件注释 7.3. 类注释 7.4. 函数注释 7.5. 变量注释 7.6. 实现注释 7.7. 标点, 拼写和语法 7.8. TODO 注释 7.9. 弃用注释 译者 (YuleFox) 笔记 8. 格式 8.1. 行长度 8.2. 非 ASCII 字符 8.3. 空格还是制表位 8.4. 函数声明与定义 8.5. Lambda 表达式 8.6. 函数调用 8.7. 列表初始化格式 8.8. 条件语句 8.9. 循环和开关选择语句 8.10. 指针和引用表达式 8.11. 布尔表达式 8.12. 函数返回值 8.13. 变量及数组初始化 8.14. 预处理指令 8.15. 类格式 8.16. 构造函数初始值列表 8.17. 名字空间格式化 8.18. 水平留白 8.19. 垂直留白 译者 (YuleFox) 笔记 译者（acgtyrant）笔记 9. 规则特例 9.1. 现有不合规范的代码 9.2. Windows 代码 10. 结束语 0. 扉页 版本: 4.45 原作者: Benjy Weinberger Craig Silverstein Gregory Eitzmann Mark Mentovai Tashana Landray 翻译: YuleFox Yang.Y acgtyrant lilinsanity 项目主页: Google Style Guide Google 开源项目风格指南 - 中文版 0.1 译者前言 Google 经常会发布一些开源项目, 意味着会接受来自其他代码贡献者的代码. 但是如果代码贡献者的编程风格与 Google 的不一致, 会给代码阅读者和其他代码提交者造成不小的困扰. Google 因此发布了这份自己的编程风格指南, 使所有提交代码的人都能获知 Google 的编程风格. 翻译初衷: 规则的作用就是避免混乱. 但规则本身一定要权威, 有说服力, 并且是理性的. 我们所见过的大部分编程规范, 其内容或不够严谨, 或阐述过于简单, 或带有一定的武断性. Google 保持其一贯的严谨精神, 5 万汉字的指南涉及广泛, 论证严密. 我们翻译该系列指南的主因也正是其严谨性. 严谨意味着指南的价值不仅仅局限于它罗列出的规范, 更具参考意义的是它为了列出规范而做的谨慎权衡过程. 指南不仅列出