关键信息
- 分类
- 转换与编码
- 输入类型
- textarea, number, select
- 输出类型
- text
- 样本覆盖
- 1
- 支持 API
- Yes
概览
TOML 格式化工具是一款专为开发者设计的在线实用工具，支持对 TOML 配置文件进行快速美化或压缩。通过调整缩进大小并选择美化或紧凑模式，您可以轻松规范代码结构，提高配置文件的可读性与规范性（请注意，格式化过程中注释会丢失，且键的顺序可能会发生改变）。
适用场景
- •在编写或编辑 Cargo.toml、pyproject.toml 等配置文件后，需要统一代码缩进和排版格式时。
- •从外部复制了排版混乱、缺乏缩进的 TOML 数据，需要快速恢复其清晰的层级结构时。
- •在生产环境部署前，需要将 TOML 配置文件进行压缩以去除多余空格和换行时。
工作原理
- •在输入框中粘贴或输入需要处理的原始 TOML 文本。
- •根据需要选择“美化”或“压缩”模式，并设置所需的缩进空格数。
- •工具通过解析器处理 TOML 数据，并实时输出格式化或压缩后的标准 TOML 文本。
使用场景
规范 Rust 项目的 Cargo.toml 依赖配置文件，使其结构清晰易读。
压缩 Python 项目的 pyproject.toml 配置文件，移除无用空格以减小体积。
快速校验手写的 TOML 语法是否正确，排查格式与拼写错误。
用户案例
1. 规范 Rust 项目 Cargo.toml 配置
Rust 开发者- 背景原因
- 在多人协作的 Rust 项目中，团队成员提交的 Cargo.toml 文件缩进不一致，排版混乱。
- 解决问题
- 需要统一配置文件缩进，使其符合团队的 2 空格缩进规范。
- 如何使用
- 将混乱的 Cargo.toml 内容粘贴到输入框，选择“美化”模式，设置缩进大小为 2，点击格式化。
- 示例配置
-
mode: beautify, indentSize: 2 - 效果
- 获得排版整齐、缩进统一为 2 个空格的标准 TOML 配置文件。
2. 压缩 pyproject.toml 配置文件
运维工程师- 背景原因
- 需要将 Python 项目的 pyproject.toml 配置文件部署到受限的容器环境中，希望尽量减小文件体积。
- 解决问题
- 去除 TOML 文件中所有不必要的空格和换行。
- 如何使用
- 将 pyproject.toml 内容粘贴至输入框，将模式切换为“压缩”，点击执行。
- 示例配置
-
mode: minify - 效果
- 输出紧凑格式的 TOML 文本，去除了所有冗余的空白字符。
用 Samples 测试
format-conversion相关专题
常见问题
格式化后我的 TOML 注释会保留吗？
不会，由于解析器限制，格式化过程中原有的注释将会丢失。
为什么格式化后键值的顺序改变了？
本工具使用 @iarna/toml 解析器，在解析和重构过程中，键的排列顺序可能会发生变化。
该工具支持哪些处理模式？
支持“美化”（Beautify）以提高可读性，以及“压缩”（Minify）以去除多余空格。
我可以自定义缩进的空格数吗？
可以，您可以在设置中调整缩进大小，支持 0 到 8 个空格。
格式化是在服务器端还是本地运行？
格式化过程完全在您的浏览器本地运行，确保您的配置数据安全不外泄。