# TOML 格式化

格式化和美化 TOML。注意：注释会丢失，键顺序可能改变（@iarna/toml 限制）

> 标准页面: https://elysiatools.com/zh/tools/toml-formatter

- **分类:** Format Conversion

- **关键词:** toml, 格式化, 美化, toml格式化工具

## 概述

TOML 格式化工具是一款专为开发者设计的在线实用工具，支持对 TOML 配置文件进行快速美化或压缩。通过调整缩进大小并选择美化或紧凑模式，您可以轻松规范代码结构，提高配置文件的可读性与规范性（请注意，格式化过程中注释会丢失，且键的顺序可能会发生改变）。

## 输入项

- **TOML 输入** (textarea): Enter your TOML here. Note: comments will be lost and key order may change after formatting.
- **缩进大小** (number): TOML uses 2 spaces (option kept for UI consistency)
- **模式** (select)

## 适用场景

- 在编写或编辑 Cargo.toml、pyproject.toml 等配置文件后，需要统一代码缩进和排版格式时。
- 从外部复制了排版混乱、缺乏缩进的 TOML 数据，需要快速恢复其清晰的层级结构时。
- 在生产环境部署前，需要将 TOML 配置文件进行压缩以去除多余空格和换行时。

## 工作原理

- 在输入框中粘贴或输入需要处理的原始 TOML 文本。
- 根据需要选择“美化”或“压缩”模式，并设置所需的缩进空格数。
- 工具通过解析器处理 TOML 数据，并实时输出格式化或压缩后的标准 TOML 文本。

## 使用案例

- 规范 Rust 项目的 Cargo.toml 依赖配置文件，使其结构清晰易读。
- 压缩 Python 项目的 pyproject.toml 配置文件，移除无用空格以减小体积。
- 快速校验手写的 TOML 语法是否正确，排查格式与拼写错误。

## 常见问题

### 格式化后我的 TOML 注释会保留吗？

不会，由于解析器限制，格式化过程中原有的注释将会丢失。

### 为什么格式化后键值的顺序改变了？

本工具使用 @iarna/toml 解析器，在解析和重构过程中，键的排列顺序可能会发生变化。

### 该工具支持哪些处理模式？

支持“美化”（Beautify）以提高可读性，以及“压缩”（Minify）以去除多余空格。

### 我可以自定义缩进的空格数吗？

可以，您可以在设置中调整缩进大小，支持 0 到 8 个空格。

### 格式化是在服务器端还是本地运行？

格式化过程完全在您的浏览器本地运行，确保您的配置数据安全不外泄。

## 相关工具

- [JSON格式化](https://elysiatools.com/zh/tools/json-formatter): 格式化和验证JSON数据
- [XML 格式化](https://elysiatools.com/zh/tools/xml-formatter): 格式化、美化和压缩 XML，支持自定义缩进。保留注释和 CDATA
- [YAML 格式化](https://elysiatools.com/zh/tools/yaml-formatter): 格式化和美化 YAML。注意：注释会丢失（js-yaml 限制）
- [CSS 格式化器](https://elysiatools.com/zh/tools/css-beautifier): 将压缩或杂乱的 CSS 代码格式化为可读、缩进良好的样式表
- [VBA代码格式化器](https://elysiatools.com/zh/tools/vba-formatter): 格式化和美化VBA代码以提高可读性
- [SQL 查询格式化器 & 压缩器](https://elysiatools.com/zh/tools/sql-query-formatter): 美化或压缩 SQL，完全可控 SQL 方言（PostgreSQL、MySQL、SQLite、SQL Server/T-SQL、BigQuery、Snowflake 等）、关键字/标识符/函数大小写、缩进风格（标准、左对齐表格、右对齐表格）以及语句间空行。输出带语法高亮、可直接复制的结果，并显示大小与语句数统计。
- [代码格式化器](https://elysiatools.com/zh/tools/code-formatter): 格式化各种语言的代码
- [JavaScript反混淆器](https://elysiatools.com/zh/tools/javascript-deobfuscator): 反混淆和分析混淆的JavaScript代码，提高可读性和理解性

## 示例

- [TOML 示例](https://elysiatools.com/zh/samples/toml-samples): TOML（Tom's Obvious, Minimal Language）格式示例，从简单到复杂结构
- [Android Java 图像处理示例](https://elysiatools.com/zh/samples/android-image-processing-java): Android Java 图像处理示例，包括图像读取保存、缩放和格式转换
- [Android Kotlin 图像处理示例](https://elysiatools.com/zh/samples/android-image-processing-kotlin): Android Kotlin 图像处理示例，包括图像读取保存、缩放和格式转换
- [Web Python 图像处理示例](https://elysiatools.com/zh/samples/web-image-processing-python): Web Python 图像处理示例，使用 PIL/Pillow 包括读取、保存、缩放和格式转换

## 相关内容

- [文本脱敏、高亮与展示格式化工具](https://elysiatools.com/zh/hubs/text-format): 在一个专题中比较文本脱敏、PII 检测、电话号码规范化、重点高亮、居中排版和 diff 格式化工具。
- [JSON 格式化、对比与规范化工具](https://elysiatools.com/zh/hubs/json-format): 在一个专题中比较 JSON 格式化、差异对比、日志审查、配置比较和数据规范化工具，适合需要让 JSON 更易读、更易审查的流程。