谷歌Java编程风格指南中文版

"Google-Java-Style-Guide-cn.pdf" 是一份中文版的谷歌Java编程风格指南，由陶冶在2020年4月23日翻译完成，基于2018年5月23日的最新版本。这份指南详细介绍了编写符合Google编程规范的Java代码的标准和建议。 **引言** 引言部分强调了学习编程规范的重要性，特别是在大型企业如Google、华为、阿里等中。作者指出，由于旧版翻译可能与当前的编程标准存在差异，因此更新翻译是为了提供最新的指导原则。 **源码文件基础守则** 1. **文件名**: 文件名应清晰反映其内容，遵循一定的命名规范。 2. **文件编码**: 建议使用UTF-8编码，以确保文件在不同系统间的一致性。 3. **特殊字符**: 避免在源码中使用特殊字符，除非它们在Unicode转义序列中。 **源文件结构** 1. **许可或版权信息**: 如果有，应在文件开头展示。 2. **包声明**: 明确指出文件所在的包。 3. **导包声明**: 使用import导入所需类，避免过多的导入导致混乱。 4. **禁止静态导入类**: 静态导入可能导致代码可读性降低，因此通常不推荐。 **格式** 1. **大括号**: 大括号的使用有特定的规则，例如类、方法、循环和条件语句等。 2. **区块缩进**: 每个层级的缩进使用2个空格。 3. **每行一条语句**: 为了提高可读性，每行只应包含一条语句。 4. **每行长度限制**: 每行代码长度不应超过100个字符。 5. **换行和空白**: 对于换行和空白的使用有明确指导，如避免不必要的空行和空格。 6. **用小括号来限定组**: 为增加可读性，推荐使用小括号来包围所有的控制结构。 7. **具体结构**: 如if、for、while等结构的格式化有具体要求。 **命名约定** 1. **通用规则**: 所有标识符应清晰、简洁并有意义。 2. **标识符类型**: 不同类型的标识符（如类、方法、变量）有不同的命名规则。 3. **CamelCase**: 定义了驼峰命名法的使用，用于标识符命名。 **编程实践** 1. **@Override**: 当重写父类方法时，应使用@Override注解。 2. **异常处理**: 不应忽视捕获的异常，而应适当处理。 3. **静态成员**: 应通过类名直接调用静态成员，避免混淆。 4. **Finalizers**: 一般情况下不推荐使用，因为它们的行为不可预测且效率低下。 **Javadoc** 1. **格式**: 描述了Javadoc的书写格式，包括注释样式。 2. **摘要片段**: Javadoc的摘要部分应简洁明了，概括方法或类的主要功能。 3. **使用Javadoc的位置**: 在需要解释的类、方法、接口等前添加Javadoc，提供代码文档。 **版本更新历史** 这部分记录了指南的更新历程，有助于追踪变化和改进。 谷歌Java编程风格指南是为保持代码一致性、可读性和可维护性而设立的准则，对于Java开发者来说，理解和遵循这些规范至关重要。