4.10. Google: Java 风格指南

• 4.10.1. 0. 扉页
• 4.10.2. 1. 介绍
  • 4.10.2.1. 1.1. 术语说明
  • 4.10.2.2. 1.2. 指南说明
• 4.10.3. 2. 源文件基础
  • 4.10.3.1. 2.1. 文件名
  • 4.10.3.2. 2.2. 文件编码：UTF-8
  • 4.10.3.3. 2.3. 特殊字符
    • 4.10.3.3.1. 2.3.1. 空白字符
    • 4.10.3.3.2. 2.3.2 特殊转义序列
    • 4.10.3.3.3. 2.3.3. 非ASCII字符
• 4.10.4. 3. 源文件结构
  • 4.10.4.1. 3.1. 许可或版权信息（如果有的话）
  • 4.10.4.2. 3.2. 包声明
  • 4.10.4.3. 3.3. 导入语句
    • 4.10.4.3.1. 3.3.1. 不使用通配符导入
    • 4.10.4.3.2. 3.3.2. 不换行
    • 4.10.4.3.3. 3.3.3. 排序和间距
    • 4.10.4.3.4. 3.3.4. 不对类使用静态导入
  • 4.10.4.4. 3.4. 类的声明
    • 4.10.4.4.1. 3.4.1. 有且仅有一个顶级类声明
    • 4.10.4.4.2. 3.4.2. 类中内容的顺序
      • 4.10.4.4.2.1. 3.4.2.1. 重载：永不分割
• 4.10.5. 4. 格式
  • 4.10.5.1. 4.1. 花括号
    • 4.10.5.1.1. 4.1.1. 选择性的花括号的使用
    • 4.10.5.1.2. 4.1.2. 非空块：K & R 风格
    • 4.10.5.1.3. 4.1.3. 空代码块：应简洁表示
  • 4.10.5.2. 4.2. 代码块缩进：增加2个空格
  • 4.10.5.3. 4.3. 一行一个语句
  • 4.10.5.4. 4.4. 列限制：100
  • 4.10.5.5. 4.5. 换行
    • 4.10.5.5.1. 4.5.1. 换行的位置
    • 4.10.5.5.2. 4.5.2. 行缩进至少4个空格
  • 4.10.5.6. 4.6. 空白字符
    • 4.10.5.6.1. 4.6.1. 垂直空白
    • 4.10.5.6.2. 4.6.2. 水平空白
    • 4.10.5.6.3. 4.6.3. 水平对齐：永远不是必要的
  • 4.10.5.7. 4.7. 分组括号：推荐使用
  • 4.10.5.8. 4.8. 具体结构
    • 4.10.5.8.1. 4.8.1. 枚举类
    • 4.10.5.8.2. 4.8.2. 变量声明
      • 4.10.5.8.2.1. 4.8.2.1. 一次只声明一个变量
      • 4.10.5.8.2.2. 4.8.2.2. 按需声明
    • 4.10.5.8.3. 4.8.3. 数组
      • 4.10.5.8.3.1. 4.8.3.1. 数组初始化器：可以是“块状”的
      • 4.10.5.8.3.2. 4.8.3.2. 不要使用C语言风格的声明
    • 4.10.5.8.4. 4.8.4. switch语句
      • 4.10.5.8.4.1. 4.8.4.1. 缩进
      • 4.10.5.8.4.2. 4.8.4.2. 贯穿：需要注释
      • 4.10.5.8.4.3. 4.8.4.3. 必须要有 default 标签
    • 4.10.5.8.5. 4.8.5. 注解
      • 4.10.5.8.5.1. 4.8.5.1. 类型注解
      • 4.10.5.8.5.2. 4.8.5.2. 类注解
      • 4.10.5.8.5.3. 4.8.5.3. 方法/构造函数注解
      • 4.10.5.8.5.4. 4.8.5.4. 字段注解
      • 4.10.5.8.5.5. 4.8.5.5. 参数/局部变量注解
    • 4.10.5.8.6. 4.8.6. 注释
      • 4.10.5.8.6.1. 4.8.6.1. 块状注释
    • 4.10.5.8.7. 4.8.7. 修饰符
    • 4.10.5.8.8. 4.8.8. 数值字面量
• 4.10.6. 5. 命名
  • 4.10.6.1. 5.1. 所有标识符通用的规则
  • 4.10.6.2. 5.2. 不同类型标识符的规则
    • 4.10.6.2.1. 5.2.1. 包名
    • 4.10.6.2.2. 5.2.2. 类名
    • 4.10.6.2.3. 5.2.3. 方法名
    • 4.10.6.2.4. 5.2.4. 常量字段名
    • 4.10.6.2.5. 5.2.5. 非常量字段名
    • 4.10.6.2.6. 5.2.6. 参数名
    • 4.10.6.2.7. 5.2.7. 局部变量名
    • 4.10.6.2.8. 5.2.8. 类型变量名
  • 4.10.6.3. 5.3. 驼峰命名法：明确规定
• 4.10.7. 6. 编程习惯
  • 4.10.7.1. 6.1 @Override ：始终使用
  • 4.10.7.2. 6.2. 捕获的异常：不应忽略
  • 4.10.7.3. 6.3. 静态成员：使用类名进行限定
  • 4.10.7.4. 6.4. 析构方法：不使用
• 4.10.8. 7. Javadoc
  • 4.10.8.1. 7.1. 格式
    • 4.10.8.1.1. 7.1.1. 一般形式
    • 4.10.8.1.2. 7.1.2. 段落
    • 4.10.8.1.3. 7.1.3. 块标签
  • 4.10.8.2. 7.2. 摘要片段
  • 4.10.8.3. 7.3. Javadoc的使用位置
    • 4.10.8.3.1. 7.3.1. 例外：不言自明的成员
    • 4.10.8.3.2. 7.3.2. 例外：重写
    • 4.10.8.3.3. 7.3.4. 非必需的Javadoc（译者注：原文中并没有7.3.3节）