痛点

配置文件用什么格式？ JSON 不适合手写，YAML 缩进容易出错。TOML 看似完美，但大多数工具生成的 TOML 嵌套层级太深：

# 默认生成的
[server]
[server.database]
[server.database.connection]
host = "localhost"
port = 5432

人类更喜欢扁平的：

# 实际想要的
[server]
database.connection = { 
  host = "localhost",
  port = 5432,
}

解决方案

json-pretty-toml - 将 JSON 转换为扁平化 TOML ，遵循三个原则：

1. 只有一层 Table（[section]）
2. Key 最多两层（section.key = value 或 section."key.name" = {...}）
3. 其余全部内联（{ ... }），使用TOML 1.1的内连风格

示例

$ echo '{"gateway":{"port":18789,"auth":{"mode":"token"}}}' | json-pretty-toml

[gateway]
port = 18789
auth.mode = "token"

支持多行内联表、自动引号转义、数组格式化等。

安装

npm install -g json-pretty-toml

或直接用 npx：

npx json-pretty-toml < config.json > config.toml

链接

• GitHub: https://github.com/nano-properties/json-pretty-toml
• npm: json-pretty-toml

适合需要阅读/偶尔编辑配置文件的场合