Google Java 编程风格指南

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

与其它的编程风格指南同样，这里所讨论的不单单是编码格式美不美观的问题， 同时也讨论一些约定及编码标准。然而，这份文档主要侧重于咱们所广泛遵循的规则， 对于那些不是明确强制要求的，咱们尽可能避免提供意见。

1.1 术语说明

在本文档中，除非另有说明：

1. 术语class可表示一个普通类，枚举类，接口或是annotation类型(@interface)

2. 术语comment只用来指代实现的注释(implementation comments)，咱们不使用“documentation comments”一词，而是用Javadoc。

其余的术语说明会偶尔在后面的文档出现。

1.2 指南说明

本文档中的示例代码并不做为规范。也就是说，虽然示例代码是遵循Google编程风格，但并不意味着这是展示这些代码的惟一方式。示例中的格式选择不该该被强制定为规则。关注公众号「程序猿DD」，领取免费学习资料，还有不定时赠书等福利等着您！

源文件基础

2.1 文件名

源文件以其最顶层的类名来命名，大小写敏感，文件扩展名为.java。

2.2 文件编码：UTF-8

源文件编码格式为UTF-8。

2.3 特殊字符

2.3.1 空白字符

除了行结束符序列，ASCII水平空格字符(0x20，即空格)是源文件中惟一容许出现的空白字符，这意味着：

1. 全部其它字符串中的空白字符都要进行转义。

2. 制表符不用于缩进。

2.3.2 特殊转义序列

对于具备特殊转义序列的任何字符(\b, \t, \n, \f, \r, ", '及)，咱们使用它的转义