原文网址:http://blog.mosil.biz/2014/05/java-style-guide/
原文授权声明(文末也有,只是拿到前面强调一次):
本篇采用创用 CC 姓名标示-非商业性-禁止改作 3.0 台湾 授权条款授权,
如欲转载请记得注明转自“[莫希尔(Mosil) 手札][1]”
转贴行为、转换成 BBS 版所需之改作(排版)行为
已征得原作者同意
某些标题长度超过 80 字,为维持 markdown 语法,因此并没有刻意断行。
______________________________________________________________________
本篇译自 [Google Java Style],该文件共分七大部份
1. Introduction
2. Source file basics
3. Source file structure
4. Formatting
5. Naming
6. Programming Practices
7. Javadoc
> **译注:**
> 本篇译文会视内容的通顺而做一些调整,并不全然照原文的字序来逐文逐句翻译。若有翻译错误或造成误会处,也麻烦请各位提出指正,感谢!
>
> **翻译版本**
> March 21, 2014
>
> **特别感谢**
> - LittleQ 以及 PsMonkey 协助校正。
> - PsMonkey 协助转成 Markdown 语法。
[Google Java Style]: http://google-styleguide.googlecode.com/
svn/trunk/javaguide.html
1. 引言 (Introduction)
=======================
本文件提供 Google 在使用 Java^(TM) 程式语言撰写原始码时,
对程式码标准的完整定义。
若且唯若 (if and only if),当一份 Java 原始档符合这份规则
才能被视为 Google 风格。
也如同其他程式风格指南一样,
这份文件所探讨的范围不仅只有格式美观的问题,
还包含了其他类型的公约以及程式码风格。
然而,本文件将着重于通常我们都会依循的必要规则 (hard-and-fast rules),
像那些不那么明确地需要被执行的部份 (不论是人或工具),
这边也会避免提供建议。
1.1 术语说明 (Terminology notes)