合併器會使用 @iarna/toml parser 解析每份 TOML,合併解析後的物件,再把結果序列化回 TOML。輸入會由左至右合併,適合處理基底設定加上 local、staging 或 production 覆寫。
當多份輸入出現相同鍵值時,你可以選擇後一份或前一份優先。巢狀 table 會遞迴合併,陣列則可依所選策略串接或取代。
因為輸出是從解析後資料重新產生,原始註解與手調空白不會被保留。將合併結果貼回套件 metadata、建置工具設定或部署設定前,請先審查。
關於這個主題的常見疑問與實用解答。
將兩份或多份 TOML 文件合併為一份,結合所有來源的 table 與欄位,並支援可設定的衝突與陣列策略。
可以。一次最多可合併五份 TOML 輸入,且會由左至右依序合併。
預設後一份輸入優先,陣列會串接。你可以切換鍵值衝突策略以保留較早輸入的值,或把陣列策略改成取代,讓後一份陣列直接勝出。
是的,巢狀表格會遞迴合併。
不會,TOML 合併完全在您的瀏覽器中執行。兩份文件透過 JavaScript 在本地合併,絕不會離開您的裝置。