失效链接处理 |
Avatar Java Style Guide PDF 下载
本站整理下载:
相关截图:
主要内容:
1. Introduction
如同其他程式風格指南一樣,這份文件所探討的範圍不僅只有格式的問題,還包含了其他類型的公約以及程式碼風格。然而,本文件將著重於通常我們都會依循的必要規則 (hard-and-fast rules),像那些不那麼明確地需要被執行的部份 (不論是人或工具),這邊也會避免提供建議。
在文件中的範例程式為非規範性的 (non-normative)。這意思是說,程式碼格式應該是要有選擇性的,而不該把範例視為唯一的風格而將之當作規則強制執行,那只是要呈現出 Avatar設計的程式碼風格。
2. Source file basics
2.1. File name
源碼檔名包含其最上層級類別 (top-level class) 並區分大小寫,再加上副檔名 .java。
Example:
2.2. File encoding: UTF-8
源碼檔的編碼格式使用 UTF-8。
Example:
2.3. Special characters
2.3.1. Whitespace characters
除了每行的結束符號, ASCII 空格符號 (0x20) 是唯一存在於源碼檔案中的空白符號,目的是為了閱讀上的舒適性。這意味著:所有的字串以及符號間皆要使用空白。
Example:
2.3.2. Special escape sequences
所有可搭配跳脫符號的字符 (\b、\t、\n、\f、\r、\”、\’ 以及 \ ) 都直接使用,而不必要轉換成相應的八進位 (如:\012) 或是 Unicode (如:\u000a) 使用之。
|