【源码简介】Google Java编程风格规范

这份文档是Google Java编程风格规范的完整定义。当且仅当一个Java源文件符合此文档中的规则， 我们才认为它符合Google的Java编程风格。

目录

前言 2

1.1 术语说明 3

1.2 指南说明 3

源文件基础 3

2.1 文件名 3

2.2 文件编码：UTF-8 3

2.3 特殊字符 4

2.3.1 空白字符 4

2.3.2 特殊转义序列 4

2.3.3 非ASCII字符 4

源文件结构 4

3.1 许可证或版权信息 5

3.2 package语句 5

3.3.2 不要换行 5

3.3.3 顺序和间距 5

4. java imports 5

3.4 类声明 6

3.4.1 只有一个顶级类声明 6

3.4.2 类成员顺序 6

格式 6

4.1 大括号 6

4.1.1 使用大括号(即使是可选的) 6

4.1.2 非空块：K & R 风格 6

4.1.3 空块：可以用简洁版本 7

4.2 块缩进：2个空格 7

4.3 一行一个语句 7

4.4 列限制：80或100 7

4.5 自动换行 8

4.5.1 从哪里断开 8

4.5.2 自动换行时缩进至少 4个空格 8

4.6 空白 8

4.6.1 垂直空白 8

4.6.2 水平空白 9

4.6.3 水平对齐：不做要求 9

4.7 用小括号来限定组：推荐 10

4.8 具体结构 10

4.8.1 枚举类 10

4.8.2 变量声明 10

4.8.3 数组 11

4.8.4.3 default的情况要写出来 12

4.8.5 注解(Annotations) 12

4.8.6 注释 12

4.8.7 Modifiers 13

命名约定 13

5.1 对所有标识符都通用的规则 13

5.2 标识符类型的规则 13

5.2.1 包名 13

5.2.2 类名 13

5.2.3 方法名 14

5.2.4 常量名 14

5.2.5 非常量字段名 14

5.2.6 参数名 15

5.2.7 局部变量名 15

5.2.8 类型变量名 15

5.3 驼峰式命名法(CamelCase) 15

编程实践 16

6.2 捕获的异常：不能忽视 16

6.3 静态成员：使用类进行调用 17

6.4 Finalizers: 禁用 17

Javadoc 17

7.1 格式 17

7.1.1 一般形式 17

7.1.2 段落 18

7.1.3 Javadoc标记 18

7.2 摘要片段 18

7.3 哪里需要使用Javadoc 18

7.3.1 例外：不言自明的方法 18

7.3.2 例外：重载 19

7.3.3 可选的Javadoc 19

【源码截图】

【核心源码】

.
└── _GoogleJava编程风格规范.docx

0 directories, 1 file