Google 开源项目风格指南 coderyi 2015-07-26 3,958 阅读3分钟 原文链接： zh-google-styleguide.readthedocs.org Google 开源项目风格指南 (中文版) C++ 风格指南 - 内容目录 0. 扉页 0.1 译者前言 0.2 背景 1. 头文件 1.1. #define 保护 1.2. 头文件依赖 1.3. 内联函数 1.4. -inl.h文件 1.5. 函数参数的顺序 1.6. #include 的路径及顺序 译者 (YuleFox) 笔记 2. 作用域 2.1. 名字空间 2.1.1. 匿名名字空间 2.1.2. 具名的名字空间 2.2. 嵌套类 2.3. 非成员函数、静态成员函数和全局函数 2.4. 局部变量 2.5. 静态和全局变量 译者 (YuleFox) 笔记 3. 类 3.1. 构造函数的职责 3.2. 默认构造函数 3.3. 显式构造函数 3.4. 拷贝构造函数 3.5. 结构体 VS. 类 3.6. 继承 3.7. 多重继承 3.8. 接口 3.9. 运算符重载 3.10. 存取控制 3.11. 声明顺序 3.12. 编写简短函数 译者 (YuleFox) 笔记 4. 来自 Google 的奇技 4.1. 智能指针 4.2. cpplint 5. 其他 C++ 特性 5.1. 引用参数 5.2. 函数重载 5.3. 缺省参数 5.4. 变长数组和 alloca() 5.5. 友元 5.6. 异常 5.7. 运行时类型识别 5.8. 类型转换 5.9. 流 5.10. 前置自增和自减 5.11. const 的使用 5.12. 整型 5.13. 64 位下的可移植性 5.14. 预处理宏 5.15. 0 和 NULL 5.16. sizeof 5.17. Boost 库 6. 命名约定 6.1. 通用命名规则 6.2. 文件命名 6.3. 类型命名 6.4. 变量命名 6.5. 常量命名 6.6. 函数命名 6.7. 名字空间命名 6.8. 枚举命名 6.9. 宏命名 6.10. 命名规则的特例 7. 注释 7.1. 注释风格 7.2. 文件注释 7.3. 类注释 7.4. 函数注释 7.5. 变量注释 7.6. 实现注释 7.7. 标点, 拼写和语法 7.8. TODO 注释 译者 (YuleFox) 笔记 8. 格式 8.1. 行长度 8.2. 非 ASCII 字符 8.3. 空格还是制表位 8.4. 函数声明与定义 8.5. 函数调用 8.6. 条件语句 8.7. 循环和开关选择语句 8.8. 指针和引用表达式 8.9. 布尔表达式 8.10. 函数返回值 8.11. 变量及数组初始化 8.12. 预处理指令 8.13. 类格式 8.14. 初始化列表 8.15. 名字空间格式化 8.16. 水平留白 8.17. 垂直留白 译者 (YuleFox) 笔记 9. 规则特例 9.1. 现有不合规范的代码 9.2. Windows 代码 10. 结束语 Objective-C 风格指南 - 内容目录 Google Objective-C Style Guide 中文版 译者的话 ewanke brantyoung 背景介绍 例子 留白和格式 空格 vs. 制表符 行宽 方法声明和定义 方法调用 @public 和 @private 异常 协议名 块（闭包） 命名 文件名 Objective-C++ 类名 类别名 Objective-C 方法名 变量名 普通变量名 实例变量 常量 注释 文件注释 版权信息及作者 声明部分的注释 实现部分的注释 对象所有权 Cocoa 和 Objective-C 特性 成员变量应该是 @private 明确指定构造函数 重载指定构造函数 重载 NSObject 的方法 初始化 避免 +new 保持公共 API 简单 #import and #include 使用根框架 构建时即设定 autorelease autorelease 优先 retain 其次 init 和 dealloc 内避免使用访问器 按声明顺序销毁实例变量 setter 应复制 NSStrings 避免抛异常 nil 检查 BOOL 若干陷阱 属性（Property） 命名 位置 字符串应使用 copy 属性（Attribute） 原子性 点引用 没有实例变量的接口 自动 synthesize 实例变量 Cocoa 模式 委托模式 模型/视图/控制器（MVC） Python 风格指南 - 内容目录 Google Python 风格指南 - 中文版 目录 背景 Python语言规范 Lint 导入 包 异常 全局变量 嵌套/局部/内部类或函数 列表推导(List Comprehensions) 默认迭代器和操作符 生成器 Lambda函数 条件表达式 默认参数值 属性(properties) True/False的求值 过时的语言特性 词法作用域(Lexical Scoping) 函数与方法装饰器 线程 威力过大的特性 Python风格规范 分号 行长度 括号 缩进 空行 空格 Shebang 注释 类 字符串 文件和sockets TODO注释 导入格式 语句 访问控制 命名 Main 临别赠言
