2 源文件基础

2.1 文件名

文件名必须全部小写，可以包含下划线（_）或短横线（-），但不能使用其他标点符号。请遵循项目使用的约定。文件扩展名必须是 .js。

2.2 文件编码：UTF-8

源文件使用 UTF-8 编码。

2.3 特殊字符

2.3.1 空白字符

除了行终止符序列外，ASCII 水平空格字符（0x20）是源文件中唯一出现的空白字符。这意味着

1. 字符串字面量中的所有其他空白字符都需要转义，并且

2. 制表符(Tab)不用于缩进。

2.3.2 特殊转义序列

对于具有特殊转义序列的任何字符（\'、\"、\\、\b、\f、\n、\r、\t、\v），使用该序列而不是相应的数字转义（例如 \x0a、\u000a 或 \u{a}）。不得使用旧式八进制转义。

2.3.3 非 ASCII 字符

对于其余的非 ASCII 字符，使用实际的 Unicode 字符（例如 ∞）或等效的十六进制或 Unicode 转义（例如 \u221e），这完全取决于哪种方式使代码更易于阅读和理解。

提示：在使用 Unicode 转义的情况下，有时甚至在使用实际 Unicode 字符时，添加解释性注释也会非常有帮助。

/* Best: perfectly clear even without a comment. */
const units = 'μs';
 
/* Allowed: but unnecessary as μ is a printable character. */
const units = '\u03bcs'; // 'μs'
 
/* Good: use escapes for non-printable characters with a comment for clarity. */
return '\ufeff' + content;  // Prepend a byte order mark.

/* Poor: the reader has no idea what character this is. */
const units = '\u03bcs';

提示：永远不要仅仅因为担心某些程序可能无法正确处理非 ASCII 字符而降低代码的可读性。如果发生这种情况，那些程序是有问题的，它们必须被修复。