合并器会使用 @iarna/toml parser 解析每份 TOML,合并解析后的对象,再把结果序列化回 TOML。输入会由左至右合并,适合处理基础配置加上 local、staging 或 production 覆盖。
当多份输入出现相同键值时,你可以选择后一份或前一份优先。嵌套 table 会递归合并,数组则可按所选策略串接或替换。
因为输出是从解析后数据重新生成,原始注释与手调空白不会被保留。将合并结果贴回包 metadata、构建工具配置或部署配置前,请先审查。
关于这个主题的常见疑问与实用解答。
将两份或多份 TOML 文档合并为一份,结合所有来源的 table 与字段,并支持可配置的冲突与数组策略。
可以。一次最多可合并五份 TOML 输入,且会由左至右依序合并。
默认后一份输入优先,数组会串接。你可以切换键值冲突策略以保留较早输入的值,或把数组策略改成替换,让后一份数组直接胜出。
是的,嵌套表格会递归合并。
不会,TOML 合并完全在您的浏览器中执行。两份文档通过 JavaScript 在本地合并,绝不会离开您的设备。