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, ", '及)，咱們使用它的轉義