Google Java编程风格规范详解

Google Java编程风格规范 Google Java编程风格规范是一份详细的编程风格指南，旨在规范Java源文件的编写格式和编码标准。这份指南涵盖了文件命名、文件编码、特殊字符处理、注释写法、编程风格等方面的规定，以确保Java源文件的格式和内容符合Google的编程风格。 1.术语说明 在Google Java编程风格规范中，术语"class"可以表示普通类、枚举类、接口或是annotation类型(@interface)。术语"comment"专门用于指代实现的注释（implementation comments），不使用“documentation comments”一词，而是用Javadoc。 2.指南说明 Google Java编程风格规范的示例代码并不作为规范。示例代码只是为了说明编程风格的规定，而不是唯一的编写方式。示例中的格式选择不应该被强制定为规则。 3.源文件基础 3.1文件名 源文件以其最顶层的类名来命名，大小写敏感，文件扩展名为.java。这意味着文件名必须与类名相同，并且区分大小写。 3.2文件编码 源文件编码格式为UTF-8。这意味着所有的源文件都必须使用UTF-8编码，以确保文件的可读性和可移植性。 3.3特殊字符 3.3.1空白字符 除了行结束符序列，ASCII水平空格字符（0x20，即空格）是源文件中唯一允许出现的空白字符。这意味着所有其它字符串中的空白字符都要进行转义。制表符不用于缩进。 3.3.2特殊转义序列 对于具有特殊转义序列的任何字符（\b,\t,\n,\f,\r,\“,\‘及\)），我们使用它的转义序列，而不是相应的八进制（比如\012）或Unicode（比如\u000a）转义。 3.3.3非ASCII字符 对于剩余的非ASCII字符，是使用实际的Unicode字符（比如∞），还是使用等价的Unicode转义符（比如\u221e），取决于哪个能让代码更易于阅读和理解。在使用Unicode转义符或是一些实际的Unicode字符时，建议做些注释给出解释，这有助于别人阅读和理解。 Google Java编程风格规范为Java开发者提供了一份详细的编程风格指南，旨在规范Java源文件的编写格式和编码标准，以确保代码的可读性、可维护性和可移植性。