原文網址: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)