如何格式化和美化 JavaScript 代码

先了解工具能做什么

JavaScript 代码格式化工具适合整理缩进混乱、换行不清晰的代码，也可以在需要减小文本体积时使用压缩模式。它接收 JavaScript 文本，并输出美化后的文本或压缩后的文本；格式化本身不代表代码已经通过验证或执行检查。

按步骤格式化 JavaScript

1. 准备 JavaScript 文本，并将其粘贴到输入区域。空白输入也可以提交，结果会是空的格式化文本。非空内容应使用字符串；通常情况下，其他类型不会被格式化。
2. 选择美化或压缩模式。未提供模式、模式为空，或使用其他字符串时，会采用美化处理；字符串 minify 会选择压缩处理。非字符串但为真值的模式可能因无法转换为小写而失败。
3. 设置缩进大小。非空输入的缩进会转换为整数；未设置时默认使用 2 个空格。无效数值以及小于 0 或大于 8 的数值会改用 2 个空格。
4. 提交格式化请求并查看输出。美化模式会按所选缩进整理文本，保留现有换行，但连续换行最多保留两行，并且不会在末尾额外添加换行。压缩模式会移除引号外的行注释和块注释，合并符合条件的空白，保留引号内的内容和转义字符，同时去除两端空白。
5. 如果非空输入超过 1,000,000 个 UTF-8 字节，格式化会失败；依赖的 JavaScript 美化组件不可用时，非空格式化也会失败。

如何阅读格式化结果

美化结果通常会出现更清楚的换行和层级，缩进宽度由设置决定；已有换行不会无限保留，结果末尾也不一定有换行。压缩结果会减少部分注释和空白，但字符串中的文字、引号以及转义字符会保留。

如果输出为空，先确认输入是否只有空格或换行；如果请求失败，检查输入是否为字符串、大小是否超过限制，以及模式是否为可转换为小写的字符串。格式化输出应作为文本整理结果阅读，不要把它当作代码执行结果或语义等价性的证明。

使用示例

开发者需要把一行 JavaScript 函数整理成更容易阅读的多行文本。

将 function greet(name){return "Hello, "+name;} 作为非空输入，选择美化模式并保留默认的 2 个空格设置，然后查看输出文本。

输出为经过整理的 JavaScript 文本：美化模式会包含分层换行，压缩模式会减少符合规则的注释和空白；引号内字符串内容保持在字符串中。

使用限制

• 非空输入受 1,000,000 个 UTF-8 字节的大小限制；所需的 JavaScript 美化组件不可用时会失败。压缩只按已说明的注释、空白和字符串规则处理。

常见错误

• 将真值的非字符串值当作模式传入，可能导致模式无法转换为小写而失败。请改用空值、未设置的模式，或使用字符串 minify；其他字符串会进入美化模式。

常见问题

没有输入内容时可以提交吗？

可以。空白输入会成功处理，并产生空的格式化文本；非空输入需要是 JavaScript 文本。

如何设置 JavaScript 的缩进？

可以，非空输入默认使用 2 个空格。无效缩进值以及超出 0 到 8 范围的值会改用 2 个空格。

怎样切换到压缩模式？

只有字符串模式 minify 会选择压缩；未提供模式、空模式或其他字符串会选择美化。真值的非字符串模式可能因不支持小写转换而失败。