配置文件整理

TOML 格式化整理排版,也留下每条说明

检查语法、定位表头,再决定是否用独立结果替换原文。

TOML 格式化

TOML 输入

格式化结果

内容只在此浏览器处理,不上传、执行、保存,也不写入网址。

默认不排序。只调整连续键组,附属注释跟随键,组标题留在原组;数组与表的顺序不变。

TOML 1.0.0 · dprint TOML 0.8.0 · toml-eslint-parser 1.0.3。语法通过不代表满足应用的 Schema。

输入最多 500,000 个 UTF-16 单元及 2 MB UTF-8;50,000 个节点,深度 100,输出 200 万字符;任务限时 5 秒。

表导航

输入 TOML 或执行校验。

TOML 格式化不该把解释配置用途的注释一起删掉。这里沿着语法树整理文本,不先转成普通对象再重建文件;你可以先看结果,再决定要不要写回输入。

这款 TOML 格式化工具适合整理项目设置中的缩进、数组和键组。TOML 校验负责语法,表导航负责定位;TOML 注释、三引号内容和重复的数组表都按真实语法识别。

为什么使用 TOML 格式化

配置变整齐,说明仍能对得上

留下设置旁的备注

TOML 格式化保留独立注释和行尾说明。开启键排序后,与键相连的前置注释随键移动;用空行分隔的组标题留在组顶部,避免把说明配给另一项。

彩色注释标记在配置条目对齐后仍与对应条目相连。

跳到真正的表头

导航列出源码中每个普通表和数组表的行列位置。数组表重复出现也各占一项;三引号文本里的方括号只是字符串内容,不会误入导航。

侧边导航连到真实表区块,多行字符串内部的方括号形状没有导航连线。

先分清校验与替换

三个容易忽略的工作方式

01

只查语法时使用独立入口

仅校验会取消等待中的自动任务,检查当前原文并提供表导航,但不生成可导出的格式化结果。再次编辑会恢复自动格式化;关闭自动后,可点格式化或按 Ctrl/Cmd+Enter。

02

按源码位置阅读配置

点击表条目或首个错误,输入框会定位到对应行列。重复数组表分别列出,长列表每次显示 50 项;分页只影响导航,不会截断下载内容。

03

写回前先核对预览

使用结果、示例、清空和本地文件替换均显示新内容及替换行数。应用后可撤销一次,恢复输入、选项、输出与错误快照。输入或参数变化时,旧结果立即停止导出。

面向真实配置的整理能力

排版可调,值的类型有依据

按语法树保留内容

格式化路径能识别带引号的键、行尾注释、内联表和多行字符串。输出接受前,会比较解析后的值、注释内容及附属关系;保留性检查失败就停止,不提供部分文件。

只排序明确的键组

默认保持键顺序。启用后仅在空行分组内排序,并保留注释对应关系;数组元素、内联表键、普通表和数组表实例均不重排。

调整缩进与换行

提供 2 个空格、4 个空格或 Tab,建议行宽为 80、100 或 120,并可输出 LF 或 CRLF。行宽是排版偏好,不能强行折断每条字符串或注释;字符串值本身保持不变。

导出当前有效结果

自动模式等待编辑停顿 350 毫秒,手动模式显示格式化按钮。任务在可取消的浏览器 Worker 中执行,限时 5 秒;剪贴板和 UTF-8 下载使用同一份当前结果。

支持范围与处理边界

语法正确之后仍需项目自身检查

明确接受 TOML 1.0.0
使用 toml-eslint-parser 1.0.3 按 TOML 1.0.0 解析,dprint TOML 0.8.0 负责排版。不能假定接受 TOML 1.1 新语法。重复键或语法错误在首个诊断处停止,并给出可定位行列,不声称一次列尽所有错误。
保留值,不保证字节相同
支持大整数、日期时间、多行文本和非有限浮点值,保留注释内容。排版会调整空白与空行,注释尾部空白可能被裁掉。注释只是文本,不指挥格式化引擎,也不触发 Schema 加载;无法确认安全保留时拒绝结果。
排序不越过语义边界
排序只针对键组,附属前置及行尾注释跟随条目。由空行隔开的组标题留在组顶。不排序普通表、数组表实例、数组元素或内联表键,也不应用 Cargo 专用规范。
不检查应用业务规则
pyproject.toml 或 Cargo.toml 语法有效,并不说明字段名、依赖约束或值类型适合项目。本页不加载远程 Schema,不解析依赖、不执行构建、不修复无效语法,也不自行删除重复键。
一次处理一份本地文本
可粘贴或选择一份 UTF-8 文件,接受 LF 和 CRLF;单独 CR 不是有效的 TOML 1.0 换行。不提供网址导入、分享配置链接、持久历史、目录批量处理或自动覆盖原件,格式转换使用其他工具。
处理有明确预算
输入上限为 500,000 个 UTF-16 单元及 2 MB UTF-8,最多 50,000 个节点、100 层深度;输出最多 200 万字符。每次 Worker 任务连同引擎加载限时 5 秒。非法 Unicode、语法、资源或保留性检查错误都会禁用导出。

TOML 格式化常见问题

多行内容、日期和注释如何处理

多层表数组能正常格式化吗?

可以处理 TOML 1.0 中有效的嵌套数组表,但仍受深度和节点预算限制。每次显式数组表头在导航中独立出现,格式化及键排序都不会改变实例先后;点击条目定位的是原始输入。

日期和时间值会发生变化吗?

TOML 格式化保留日期时间类型及值,不先转成 JSON 字符串。保留性检查使用原始数字和日期标记,避免经过 JavaScript Number 或 Date 时丢失精度;不符合接受语法的输入会报错。

三引号多行文本是否受支持?

有效的 TOML 1.0 多行基本字符串和字面量字符串均可处理。字符串里的内容仍是值,其中类似 [server] 的行不会被当作表头。格式化不会为满足建议行宽而改写字符串值。

格式化后原来的注释还在吗?

TOML 格式化保留注释内容和需要跟随条目的关系。可选排序可能移动附属注释,组标题留在各组;注释尾部空白可能裁掉,空行布局可能变化,因此并非逐字节保留原文件。

输入内容会留存在服务器吗?

输入在浏览器 Worker 内处理,不随格式化引擎资源请求上传,也没有保存输入的历史功能。TOML 格式化只在你请求下载时生成新文件,不会自动覆盖本地原件。

遇到需要核对的注释或表布局?

试用 TOML 格式化

使用 TOML 格式化检查注释、表位置和键组排序结果,再决定是否替换项目配置。

语法检查不能代替项目自身的校验。