YAML 驗證與格式化工具
驗證 YAML、格式化縮排、排序鍵,並將 YAML 轉換為 JSON,整個過程不會把文件送往任何地方。
input.yaml
output.yaml
相關
與 YAML Fix 相關的指南
YAML 校驗與格式化工具
貼上 YAML 即可立即檢查語法錯誤。校驗器會反白標示出錯的確切行數。你也可以用一致的縮排重新格式化 YAML,或一鍵轉換為 JSON。
同一個工具可以充當 yaml lint / yaml linter /** yamllint** / yaml checker /** online yaml validator** —— 貼上任何 YAML,它都會以行與欄回報第一個解析失敗。把它當作 validate yaml online 來用:格式化、lint 與轉換都在本地完成,不會上傳任何內容。
YAML 與 JSON: 兩者都是資料交換格式,YAML 1.2 是 JSON 的嚴格超集,因此任何 JSON 文件本身就是合法的 YAML。實際上兩者的差別在於型態 —— YAML 使用縮排,並且對註解友善(適合人工編輯的設定),JSON 使用括號且語法嚴格(適合 API)。當你需要把設定餵給只接受 JSON 的工具時,點擊 To JSON。
- Validate —— 嚴格的 YAML 1.2 解析,可精準回報錯誤的行 / 欄
- Format YAML —— 將縮排(2 個空格)與鍵順序正規化
- Convert to JSON —— 輸出有效、漂亮縮排的 JSON,可直接用於 API
常見的 YAML 錯誤
用了 Tab 而非空格
YAML 不允許以 Tab 縮排。請將所有 Tab 替換為空格。
縮排不一致
同一父鍵之下的子鍵,必須相對父鍵縮排相同數量的空格。
未加引號的特殊字元
以 :、- 或 # 開頭的值,通常需要以引號包起來。
FAQ
為什麼我的 YAML 解析失敗?
幾乎都是縮排問題:要麼混入了 Tab(YAML 不允許以 Tab 縮排),要麼同層級的鍵深度不一致。格式化器會把所有內容重寫成單一、以空格為基礎的寬度,這通常能讓大部分這類問題現形並修好。