如何格式化和整理文本与代码

为什么有用

某位后端工程师从客户工单里粘贴了一段 4KB 的 JSON 负载，却是一整行连在一起。单凭肉眼很难立刻判断究竟是缺字段还是枚举命名错了。在格式化器里花上三十秒，结构就一目了然：原来是 currrency（三个 r）拼写错误。这就是格式化在日常里的价值——把读不下去的整块文本变成人可以推理的形态。

格式化还可以作为统一的风格锚点：当每个人都用同样的美化默认项时，代码评审就不会再被空格噪音淹没，可以更聚焦逻辑。

三类真实场景

后端工程师

快速检查工单里的响应负载

粘贴单行 JSON，用 2 空格缩进美化，立刻发现字段异常。

秒级定位问题

前端开发

压缩配置片段以供 CDN 文件使用

把手写编辑过的 HTML/CSS 丢进去点 压缩（Minify），得到更精简的产物。

更小体积

数据分析师

分享前把 SQL 整理成可读版

粘贴扁平单行的 SELECT 联结链，用 SQL 配置文件格式化后，联结键、过滤与聚合一眼可读。

易于评审的分析

操作演示

格式化器在 /content-tools/text-formatter。它会根据输入猜测语言，也可在工具栏里手动切换。

选择语言配置文件
在 JSON、JavaScript/TypeScript、HTML、CSS、SQL 中选择。选对配置可避免 JSON 格式化器误判 JS 箭头函数花括号一类的细节问题。
粘贴源码
编辑器可接受任意大小输入；粘贴内容仅保存在当前浏览器会话中。
美化或压缩
格式化（Format） 会缩进与换行；压缩会去掉空格与注释。调整设置时右侧结果会实时更新。
微调缩进、行宽与尾逗号
可选用 2 或 4 空格、设定最大行宽，并切换尾逗号以匹配团队风格指南。
复制或下载
用复制按钮贴回 IDE，或直接下载文件。

美化扁平化的工单 JSON 负载

Input

{"orderId":"o-7711","items":[{"sku":"A1","qty":2},{"sku":"B2","qty":1}],"currrency":"USD"}

Output

{
  "orderId": "o-7711",
  "items": [
    { "sku": "A1", "qty": 2 },
    { "sku": "B2", "qty": 1 }
  ],
  "currrency": "USD"
}

MoreKits 双栏格式化器视图，含语言选择与缩进选项 — 选择语言、设定缩进与行宽后，右侧会随输入实时更新。

实用技巧

先格式化再 diff。 比较两份配置前，先分别走一遍格式化，可消除空格与引号写法差异。在线对比文本可作参考。
在填入不允许换行的 JSON 配置字段前先压缩（Minify）（如 Slack webhook、部分 k8s annotation）。
Tab 与空格要一致 —— 格式化前先调好缩进设置，否则编辑器保存时再格式化会产生大量噪声 diff。
JSON5 类写法：手写配置有时会带注释。可先用 JS 配置去掉注释，再用严格 JSON 重新格式化。

常见陷阱

常见误区

JSON 无法美化

尾逗号、单引号或未加引号的键都会导致非法 JSON。先按工具栏提示修复语法错误（会标出出错行），再重新格式化。

常见误区

压缩后的 JS 在运行时出问题

压缩器会合并对自动分号插入（ASI）敏感的代码行。若要压缩依赖可选链或顶层 await 的现代代码，请确认目标运行时支持这些特性；否则请先用打包器 transpile。

常见误区

SQL 格式化破坏了别名

部分老式方言用双引号包裹标识符。请在 SQL 配置中选择对应方言（PostgreSQL、MySQL、T-SQL），以保留标识符引用方式。

什么情况不该用这个工具

自动修复 lint 报错：请在仓库内使用 ESLint、Stylelint、dotnet format 等能做规则驱动的清理。
重构（重命名、提取函数）：应用 IDE 的重构引擎。
Schema 校验：此工具只校验结构合法性；语义校验请用 JSON Schema 等校验器。

常见问题

会改动引号内的空白吗？

不会。引号内部的空白保持原样——只有结构性空白（缩进、词元之间的换行）会被重写。

支持 YAML 吗？

直接格式化 YAML 在路线图中；当前可先转成 JSON → 格式化 → 再转回 YAML。

压缩后注释为什么不见了？

压缩默认会移除注释以减小体积。若输出需要保留注释，请在工具栏打开 Preserve comments（保留注释）。

后续可以做什么

用文本对比将格式化结果与基准版本比对。
若要将结果嵌入 HTML 或 JSON，可用文本转义/反转义处理剩余特殊字符。
用 Markdown 转 HTML 把 Markdown 草稿转为 HTML。

为什么有用

格式化还可以作为统一的风格锚点：当每个人都用同样的美化默认项时，代码评审就不会再被空格噪音淹没，可以更聚焦逻辑。

三类真实场景

后端工程师

快速检查工单里的响应负载

粘贴单行 JSON，用 2 空格缩进美化，立刻发现字段异常。

秒级定位问题

前端开发

压缩配置片段以供 CDN 文件使用

把手写编辑过的 HTML/CSS 丢进去点 压缩（Minify），得到更精简的产物。

更小体积

数据分析师

分享前把 SQL 整理成可读版

粘贴扁平单行的 SELECT 联结链，用 SQL 配置文件格式化后，联结键、过滤与聚合一眼可读。

易于评审的分析

操作演示

格式化器在 /content-tools/text-formatter。它会根据输入猜测语言，也可在工具栏里手动切换。

选择语言配置文件
在 JSON、JavaScript/TypeScript、HTML、CSS、SQL 中选择。选对配置可避免 JSON 格式化器误判 JS 箭头函数花括号一类的细节问题。
粘贴源码
编辑器可接受任意大小输入；粘贴内容仅保存在当前浏览器会话中。
美化或压缩
格式化（Format） 会缩进与换行；压缩会去掉空格与注释。调整设置时右侧结果会实时更新。
微调缩进、行宽与尾逗号
可选用 2 或 4 空格、设定最大行宽，并切换尾逗号以匹配团队风格指南。
复制或下载
用复制按钮贴回 IDE，或直接下载文件。

美化扁平化的工单 JSON 负载

Input

{"orderId":"o-7711","items":[{"sku":"A1","qty":2},{"sku":"B2","qty":1}],"currrency":"USD"}

Output

{
  "orderId": "o-7711",
  "items": [
    { "sku": "A1", "qty": 2 },
    { "sku": "B2", "qty": 1 }
  ],
  "currrency": "USD"
}

实用技巧

先格式化再 diff。 比较两份配置前，先分别走一遍格式化，可消除空格与引号写法差异。在线对比文本可作参考。
在填入不允许换行的 JSON 配置字段前先压缩（Minify）（如 Slack webhook、部分 k8s annotation）。
Tab 与空格要一致 —— 格式化前先调好缩进设置，否则编辑器保存时再格式化会产生大量噪声 diff。
JSON5 类写法：手写配置有时会带注释。可先用 JS 配置去掉注释，再用严格 JSON 重新格式化。

常见陷阱

常见误区

JSON 无法美化

尾逗号、单引号或未加引号的键都会导致非法 JSON。先按工具栏提示修复语法错误（会标出出错行），再重新格式化。

常见误区

压缩后的 JS 在运行时出问题

常见误区

SQL 格式化破坏了别名

部分老式方言用双引号包裹标识符。请在 SQL 配置中选择对应方言（PostgreSQL、MySQL、T-SQL），以保留标识符引用方式。

什么情况不该用这个工具

自动修复 lint 报错：请在仓库内使用 ESLint、Stylelint、dotnet format 等能做规则驱动的清理。
重构（重命名、提取函数）：应用 IDE 的重构引擎。
Schema 校验：此工具只校验结构合法性；语义校验请用 JSON Schema 等校验器。

常见问题

会改动引号内的空白吗？

不会。引号内部的空白保持原样——只有结构性空白（缩进、词元之间的换行）会被重写。

支持 YAML 吗？

直接格式化 YAML 在路线图中；当前可先转成 JSON → 格式化 → 再转回 YAML。

压缩后注释为什么不见了？

压缩默认会移除注释以减小体积。若输出需要保留注释，请在工具栏打开 Preserve comments（保留注释）。

后续可以做什么

用文本对比将格式化结果与基准版本比对。
若要将结果嵌入 HTML 或 JSON，可用文本转义/反转义处理剩余特殊字符。
用 Markdown 转 HTML 把 Markdown 草稿转为 HTML。