内容目录

• 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.2. 匿名命名空间和静态变量
    • 2.3. 非成员函数、静态成员函数和全局函数
    • 2.4. 局部变量
    • 2.5. 静态和全局变量
    • 译者 (YuleFox) 笔记
    • 译者（acgtyrant）笔记
  • 3. 类
    • 3.1. 构造函数的职责
    • 3.2. 隐式类型转换
    • 3.3. 可拷贝类型和可移动类型
    • 3.4. 结构体 VS. 类
    • 3.5. 继承
    • 3.6. 多重继承
    • 3.7. 接口
    • 3.8. 运算符重载
    • 3.9. 存取控制
    • 3.10. 声明顺序
    • 译者 (YuleFox) 笔记
  • 4. 函数
    • 4.1. 输入和输出
    • 4.2. 编写简短函数
    • 4.3. 引用参数
    • 4.4. 函数重载
    • 4.5. 缺省参数
    • 4.6. 函数返回类型后置语法
  • 5. 来自 Google 的奇技
    • 5.1. 所有权与智能指针
    • 5.2. Cpplint
    • 译者（acgtyrant）笔记
  • 6. 其他 C++ 特性
    • 6.1. 引用参数
    • 6.2. 右值引用
    • 6.3. 函数重载
    • 6.4. 缺省参数
    • 6.5. 变长数组和 alloca()
    • 6.6. 友元
    • 6.7. 异常
    • 6.8. 运行时类型识别
    • 6.9. 类型转换
    • 6.10. 流
    • 6.11. 前置自增和自减
    • 6.12. const 用法
    • 6.13. constexpr 用法
    • 6.14. 整型
    • 6.15. 64 位下的可移植性
    • 6.16. 预处理宏
    • 6.17. 0, nullptr 和 NULL
    • 6.18. sizeof
    • 6.19. auto
    • 6.20. 列表初始化
    • 6.21. Lambda 表达式
    • 6.22. 模板编程
    • 6.23. Boost 库
    • 6.24. C++11
    • 译者（acgtyrant）笔记
  • 7. 命名约定
    • 7.1. 通用命名规则
    • 7.2. 文件命名
    • 7.3. 类型命名
    • 7.4. 变量命名
      • 普通变量命名
      • 类数据成员
      • 结构体变量
    • 7.5. 常量命名
    • 7.6. 函数命名
    • 7.7. 命名空间命名
    • 7.8. 枚举命名
    • 7.9. 宏命名
    • 7.10. 命名规则的特例
    • 译者（acgtyrant）笔记
  • 8. 注释
    • 8.1. 注释风格
    • 8.2. 文件注释
      • 法律公告和作者信息
      • 文件内容
    • 8.3. 类注释
    • 8.4. 函数注释
      • 函数声明
      • 函数定义
    • 8.5. 变量注释
      • 类数据成员
      • 全局变量
    • 8.6. 实现注释
      • 代码前注释
      • 行注释
      • 函数参数注释
      • 不允许的行为
    • 8.7. 标点, 拼写和语法
    • 8.8. TODO 注释
    • 8.9. 弃用注释
    • 译者 (YuleFox) 笔记
  • 9. 格式
    • 9.1. 行长度
    • 9.2. 非 ASCII 字符
    • 9.3. 空格还是制表位
    • 9.4. 函数声明与定义
    • 9.5. Lambda 表达式
    • 9.6. 函数调用
    • 9.7. 列表初始化格式
    • 9.8. 条件语句
    • 9.9. 循环和开关选择语句
    • 9.10. 指针和引用表达式
    • 9.11. 布尔表达式
    • 9.12. 函数返回值
    • 9.13. 变量及数组初始化
    • 9.14. 预处理指令
    • 9.15. 类格式
    • 9.16. 构造函数初始值列表
    • 9.17. 命名空间格式化
    • 9.18. 水平留白
      • 通用
      • 循环和条件语句
      • 操作符
      • 模板和转换
    • 9.19. 垂直留白
    • 译者 (YuleFox) 笔记
    • 译者（acgtyrant）笔记
  • 10. 规则特例
    • 10.1. 现有不合规范的代码
    • 10.2. Windows 代码
  • 11. 结束语
• Objective-C 风格指南 - 内容目录
  • Google Objective-C Style Guide 中文版
    • 译者的话
      • ewanke
      • Yang.Y
    • 背景介绍
    • 例子
  • 留白和格式
    • 空格 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 风格指南 - 内容目录
  • 扉页
  • 背景
  • Python语言规范
    • Lint
    • 导入
    • 包
    • 异常
    • 全局变量
    • 嵌套/局部/内部类和函数
    • 推导式和生成式
    • 默认迭代器和操作符
    • 生成器
    • Lambda函数
    • 条件表达式
    • 默认参数值
    • 特性 (properties)
    • True/False的求值
    • 词法作用域(Lexical Scoping, 又名静态作用域)
    • 函数与方法装饰器
    • 线程
    • 威力过大的特性
    • 现代python: from __future__ imports
    • 代码类型注释
  • Python风格规范
    • 分号
    • 行宽
    • 括号
    • 缩进
    • 序列的尾部要添加逗号吗?
    • Shebang行
    • 注释和文档字符串 (docstring)
    • 标点符号、拼写和语法
    • 字符串
    • 文件、套接字 (socket) 和类似的有状态资源
    • TODO (待办) 注释
    • 导入 (import) 语句的格式
    • 语句
    • 访问器 (getter) 和设置器 (setter)
    • 命名
    • 主程序
    • 函数长度
    • 类型注解 (type annotation)
  • 临别赠言
• Shell 风格指南 - 内容目录
  • 扉页
  • 背景
    • 使用哪一种Shell
    • 什么时候使用Shell
  • Shell文件和解释器调用
    • 文件扩展名
    • SUID / SGID
  • 环境
    • STDOUT vs STDERR
  • 注释
    • 文件头
    • 功能注释
    • 实现部分的注释
    • TODO注释
  • 格式
    • 缩进
    • 行的长度和长字符串
    • 管道
    • 循环
    • case语句
    • 变量扩展
    • 引用
  • 特性及错误
    • 命令替换
    • test，[和[[
    • 测试字符串
    • 文件名的通配符扩展
    • Eval
    • 管道导向while循环
  • 命名约定
    • 函数名
    • 变量名
    • 常量和环境变量名
    • 源文件名
    • 只读变量
    • 使用本地变量
    • 函数位置
    • 主函数main
  • 调用命令
    • 检查返回值
    • 内建命令和外部命令
  • 结论
• Javascript 风格指南 - 内容目录
  • 背景
  • Javascript语言规范
    • var关键字
      • 描述
    • 常量
      • 描述
        • 常量值
        • 常量指针（变量和属性）
        • 例子
    • 分号
      • 发生了什么？
      • 为什么？
      • 澄清：分号和函数
    • 嵌套函数
    • 块内函数声明
    • 异常
    • 自定义异常
    • 标准功能
    • 原始类型的包装对象
    • 多重的原型继承
    • 方法和属性定义
      • 为什么？
    • 删除
    • 闭包
    • eval()函数
    • with() {}
    • this
    • for-in 循环
    • 关联数组
    • 多行的字符串字面量
    • 数组和对象字面量
    • 修改内置对象原型
    • Internet Explorer中的条件注释
  • Javascript风格规范
    • 命名
      • 属性和方法
      • 方法和函数参数
      • getter和setter
      • 存取函数
      • 命名空间
        • 为全局代码使用命名空间
        • 尊重命名空间所有权
        • 外部代码和内部代码使用不同的命名空间
        • 为长类型的名称提供别名提高可读性
      • 文件名
    • 自定义 toString() 方法
    • 延时初始化
    • 明确作用域
    • 代码格式
      • 大括号
      • 数组和对象初始化表达式
      • 函数参数
      • 匿名函数传递
      • 使用goog.scope命名别名
      • 更多的缩进
      • 空行
      • 二元和三元操作符
    • 括号
    • 字符串
    • 可见性（私有和保护类型字段）
    • JavaScript类型
      • JavaScript类型语言
      • JavaScript中的类型
      • 类型转换
      • 可为空与可选的参数和属性
      • 类型定义
      • 模板类型
    • 注释
      • 注释语法
      • JSDoc 缩进
      • JSDoc中的HTML
      • 顶层/文件层注释
      • Class评论
      • 方法和功能注释
      • 属性评论
      • JSDoc标签参考
    • 为goog.provide提供依赖
    • 编译
    • 技巧和诀窍
      • True和False布尔表达式
      • 条件（三元）操作符（？：）
      • && 和 ||
      • 遍历节点列表
• TypeScript 风格指南
  • 1. 前言
    • 1.1. 简介
    • 1.2. 翻译信息
      • 1.2.1. 上次更新日期
      • 1.2.2. 作者
      • 1.2.3. 原文链接
      • 1.2.4. 中文版链接
      • 1.2.5. 修订历史
  • 2. 语法规范
    • 2.1. 标识符
      • 2.1.1. 命名规范
        • 2.1.1.1. 缩写
        • 2.1.1.2. 美元符号 $
        • 2.1.1.3. 类型参数
        • 2.1.1.4. 测试用例
        • 2.1.1.5. _ 前缀与后缀
        • 2.1.1.6. 导入模块
        • 2.1.1.7. 常量
        • 2.1.1.8. 其他
      • 2.1.2. 别名
      • 2.1.3. 命名风格
      • 2.1.4. 描述性命名
    • 2.2. 文件编码
    • 2.3. 注释与文档
      • 2.3.1. 用 JSDoc 还是 注释？
      • 2.3.2. JSDoc 规范
      • 2.3.3. 对所有导出的顶层模块进行注释
      • 2.3.4. 省略对于 TypeScript 而言多余的注释
      • 2.3.5. 不要使用 @override
      • 2.3.6. 注释必须言之有物
      • 2.3.7. 参数属性注释
      • 2.3.8. 函数调用注释
      • 2.3.9. 将文档置于装饰器之前
  • 3. 语言特性
    • 3.1. 可见性
    • 3.2. 构造函数
    • 3.3. 类成员
      • 3.3.1. #private 语法
      • 3.3.2. 使用 readonly
      • 3.3.3. 参数属性
      • 3.3.4. 字段初始化
      • 3.3.5. 用于类的词法范围之外的属性
      • 3.3.6. 取值器与设值器（存取器）
    • 3.4. 原始类型与封装类
    • 3.5. 数组构造函数
    • 3.6. 强制类型转换
    • 3.7. 变量
    • 3.8. 异常
    • 3.9. 对象迭代
    • 3.10. 容器迭代
    • 3.11. 展开运算符
    • 3.12. 控制流语句 / 语句块
    • 3.13. switch 语句
    • 3.14. 相等性判断
    • 3.15. 函数声明
    • 3.16. 函数表达式
      • 3.16.1. 在表达式中使用箭头函数
      • 3.16.2. 表达式函数体 和 代码块函数体
      • 3.16.3. 重新绑定 this
      • 3.16.4. 使用箭头函数作为属性
      • 3.16.5. 事件句柄
    • 3.17. 自动分号插入
    • 3.18. @ts-ignore
    • 3.19. 类型断言与非空断言
      • 3.19.1. 类型断言语法
      • 3.19.2. 类型断言和对象字面量
    • 3.20. 成员属性声明
      • 3.20.1. 优化属性访问的兼容性
      • 3.20.2. 优化模块对象导入的兼容性
      • 3.20.3. 例外情况
    • 3.21. 枚举
    • 3.22. debugger 语句
    • 3.23. 装饰器
  • 4. 代码管理
    • 4.1. 模块
      • 4.1.1. 导入路径
      • 4.1.2. 用 命名空间 还是 模块？
    • 4.2. 导出
      • 4.2.1. 导出可见性
      • 4.2.2. 可变导出
      • 4.2.3. 容器类
    • 4.3. 导入
      • 4.3.1. 选择模块导入还是解构导入？
      • 4.3.2. 重命名导入
      • 4.3.3. import type 和 export type
    • 4.4. 根据特征组织代码
  • 5. 类型系统
    • 5.1. 类型推导
      • 5.1.1. 返回类型
    • 5.2. Null 还是 Undefined ？
      • 5.2.1. 可空/未定义类型别名
      • 5.2.2. 可选参数 还是 undefined 类型？
    • 5.3. 结构类型 与 指名类型
    • 5.4. 接口 还是 类型别名？
    • 5.5. Array<T> 类型
    • 5.6. 索引类型 {[key: string]: number}
    • 5.7. 映射类型与条件类型
    • 5.8. any 类型
      • 5.8.1. 提供一个更具体的类型
      • 5.8.2. 使用 unknown 而非 any
      • 5.8.3. 关闭 Lint 工具对 any 的警告
    • 5.9. 元组类型
    • 5.10. 包装类型
    • 5.11. 只有泛型的返回类型
  • 6. 一致性
    • 6.1. 目标
• HTML/CSS 风格指南 - 内容目录
  • 背景
  • 整体样式规则
    • 协议
  • 总体排版规则
    • 缩进
    • 大小写
    • 尾部的空格
  • 整体的元数据规则
    • 编码
    • 注释
    • 处理内容
  • HTML样式规则
    • 文档类型
    • HTML合法性
    • 语义化
    • 多媒体降级
    • 关注点分离
    • 实体引用
    • 可选的标签
    • type属性
  • HTML格式规则
    • 常规格式化
    • HTML引号
  • css样式规则
    • CSS有效性
    • id与class的命名
    • id与class的命名规范
    • 选择器的类型
    • 简写属性
    • 0与单位
    • 前导0
    • 十六进制表示法
    • 前缀选择器
    • id与class名称分隔符
    • Hacks
  • CSS格式化规则
    • 声明顺序
    • 块内容的缩进
    • 声明结束
    • CSS属性名结束
    • 声明块间隔
    • 选择器及声明分离
    • CSS代码块分离
    • CSS引号
  • CSS元规则
    • 分段规则
  • 赠言