重點摘要
- 01使用 js-yaml 解析器以一致的縮排格式化 YAML — Node.js 建置工具中使用的相同程式庫。
- 02驗證語法並報告錯誤的確切行號。
- 03在 YAML 和 JSON 之間雙向轉換，具有正確的類型保留。
- 04無需上傳 — 整個作業完全在您的瀏覽器中本地執行。
為什麼 YAML 格式化對設定檔很重要
YAML 是 Kubernetes、GitHub Actions、Docker Compose、Helm 圖表和許多其他工具的預設設定語言。它也以對縮排很敏感而聞名 — 一行縮排錯誤可能會產生無訊息類型不匹配或硬解析錯誤，阻止部署。定期格式化可使檔案保持一致，並在問題到達 CI 之前捕獲它們。
在 YAML 和 JSON 之間轉換同樣有用。某些工具只接受 API 呼叫或結構描述定義的 JSON，而人類通常更喜歡長期有效的設定檔的 YAML。能夠在兩者之間來回不失資料類型 — 數字保持數字，布林值保持布林值 — 可以節省時間並防止細微的錯誤。
如何格式化或轉換 YAML
- 01
貼上您的 YAML 或 JSON
貼上 Kubernetes 資訊清單、GitHub Actions 工作流程、Helm 值檔案或任何其他 YAML 文件。對於 JSON 到 YAML 的轉換，改為貼上 JSON。
- 02
選擇一個動作
選擇 [格式化 YAML] 以正規化縮排並在原地清理文件。選擇 [YAML 到 JSON] 或 [JSON 到 YAML] 以完全轉換格式。
- 03
檢查錯誤（如有）
如果輸入有語法錯誤，該工具會從 js-yaml 解析器呈現確切的行號和原因 — 與您的 Node.js 工具相同的解析器，所以錯誤與您在生產中看到的內容相符。
- 04
複製輸出
點擊 [複製] 以取得格式化或轉換的輸出。貼回您的設定檔、API 本體或結構描述定義。
此工具何時節省您的時間
- 01Kubernetes 資訊清單已漂移 — 在提交之前正規化縮排。
- 02GitHub Actions 工作流程無法解析 — 驗證以取得確切的錯誤行。
- 03API 只接受 JSON 但設定存儲為 YAML — 一鍵轉換。
- 04上線新服務 — 將 JSON 範例裝載轉換為 YAML 以用於 Helm 圖表。
- 05從堆疊溢位複製 YAML — 重新格式化以符合您專案的 2 空格樣式。
- 06除錯 Helm 值合併 — 驗證每個 values.yaml 都單獨乾淨。
私密，無需上傳
格式化和轉換完全在您的瀏覽器中使用 js-yaml 執行 — 與 Webpack、Rollup 和大多數 JavaScript 建置工具捆綁的相同程式庫。您的設定檔、秘密引用和環境變數名稱永遠不會離開您的裝置。
解析器針對 YAML 1.2，這是 Kubernetes、GitHub Actions 和 Docker Compose 都使用的版本。如果檔案在此驗證，它會在這些工具中正確載入。
YAML 格式化工具常見問題
YAML 格式化會保留註解嗎？
不會。js-yaml 解析器在解析期間會移除註解 — 這是所有 JavaScript YAML 解析器的限制。先格式化，然後手動新增註解。
此工具支援哪個 YAML 版本？
YAML 1.2，這是 Kubernetes、GitHub Actions、Docker Compose 和 Helm 使用的版本。在此驗證的內容將在這些工具中乾淨地載入。
從 YAML 轉換為 JSON 時是否會保留類型？
是的。數字、布林值、null 和日期字串會正確往返。YAML 中的 true 在 JSON 中變成布林值 true，而不是字串 'true'。
格式化和轉換之間有什麼區別？
格式化將檔案保持為 YAML 並正規化空白和縮排。轉換完全改變輸出格式 — YAML 到 JSON 產生 .json 相容的文件。
我的 YAML 有多個由 --- 分隔的文件。它們都會被處理嗎？
第一個文件會被解析並重新發出。對於多文件檔案，在 --- 上分割每個區段並個別處理它們。