源文件以其最顶层的类名来命名,大小写敏感,文件扩展名为.java。
源文件编码格式为UTF-8。
除了行结束符序列,ASCII水平空格字符(0x20,即空格)是源文件中唯一允许出现的空白字符,这意味着:所有其它字符串中的空白字符都要进行转义。 制表符不用于缩进。
对于具有特殊转义序列的任何字符(\b, \t, \n, \f, \r, \“, \‘及),我们使用它的转义序列,而不是相应的八进制(比如\012)或Unicode(比如\u000a)转义。
对于剩余的非ASCII字符,是使用实际的Unicode字符(比如∞),还是使用等价的Unicode转义符(比如\u221e),取决于哪个能让代码更易于阅读和理解。
小提示:在使用Unicode转义符或是一些实际的Unicode字符时,建议做些注释给出解释,这有助于别人阅读和理解。
例如:
代码注释 | 描述 |
---|---|
String unitAbbrev = "μs"; | 赞,即使没有注释也非常清晰 |
String unitAbbrev = "\u03bcs";// "μs" | 允许,但没有理由要这样做 |
String unitAbbrev = "\u03bcs"; // Greek letter mu, "s" | 允许,但这样做显得笨拙还容易出错 |
String unitAbbrev = "\u03bcs"; | 很糟,读者根本看不出这是什么 |
return '\ufeff' + content; // byte order mark | Good,对于非打印字符,使用转义,并在必要时写上注释 |
小提示:永远不要由于害怕某些程序可能无法正确处理非ASCII字符而让你的代码可读性变差。当程序无法正确处理非ASCII字符时,它自然无法正确运行, 你就会去fix这些问题的了。(言下之意就是大胆去用非ASCII字符,如果真的有需要的话)