術語中英對照——把 YAML 的每個關鍵字與「它對應的概念」對起來。名稱 / 英文 / 說明 / 出自單元。
基本語法
| 名稱 | 英文 | 說明 | 單元 |
|---|
| 鍵值對 | Key-Value Pair | key: value，冒號後要加一個空格 | 單元 2 |
| 縮排 | Indentation | 用空格數表達巢狀層級；禁用 Tab，慣用兩空格 | 單元 2 |
| 註解 | Comment | # 開頭到行尾；可放在行尾 | 單元 2 |
| 空值 | Null | null、~、或留空三種寫法，都代表空值 | 單元 2 |
| 文件分隔 | Document Separator | --- 分隔多份文件；... 表示文件結束 | 單元 2 |
| 對映 | Mapping | 鍵值組容器，等價 dict / object（單元 4） | 單元 4 |
| 序列 | Sequence | 有序清單，- 開頭，等價 list / array（單元 4） | 單元 4 |
| Flow Style | Flow Style | [ ] / { } 一行寫完的精簡式（單元 4） | 單元 4 |
字串與結構
| 名稱 | 英文 | 說明 | 單元 |
|---|
| Plain 字串 | Plain Scalar | 不加引號的預設寫法；特殊字元要小心 | 單元 3 |
| 單引號字串 | Single-Quoted | '…' 照單全收，'' 代表一個引號；不處理跳脫 | 單元 3 |
| 雙引號字串 | Double-Quoted | "…" 支援跳脫 \n、\t、\" 等 | 單元 3 |
| 多行區塊 | Block Scalar | | | 保留所有換行，適合程式碼、日誌 | 單元 3 |
| 摺疊區塊 | Folded Scalar > | > 把軟換行摺疊成空格，適合長段落 | 單元 3 |
| 修剪後綴 | Chomping | | 或 > 後加 -（去換行）/ +（留換行） | 單元 3 |
| 巢狀結構 | Nesting | 對映與序列可任意混用到任意深度（單元 4） | 單元 4 |
型別與進階
| 名稱 | 英文 | 說明 | 單元 |
|---|
| 自動推斷 | Type Inference | 像數字的當數字、像布林的當布林 | 單元 5 |
| 布林 | Boolean | true / false；1.1 還會把 yes/on/off 當布林 | 單元 5 |
| 型別標籤 | Type Tag | !!str 強制當字串，!!binary 表示 base64 | 單元 5 |
| 時間戳 | Timestamp | ISO 8601 如 2026-08-15 會被推斷成日期物件 | 單元 5 |
| 錨點 | Anchor | &name 把一個節點記名，定義一次 | 單元 6 |
| 別名 | Alias | *name 完整複製錨點指向的節點 | 單元 6 |
| 合併鍵 | Merge Key | <<: *anchor 展開合併欄位，並可覆寫（1.1） | 單元 6 |
生態系與工具
| 名稱 | 英文 | 說明 | 單元 |
|---|
| Frontmatter | Frontmatter | Markdown 檔首 --- 區塊，用 YAML 描述文件屬性 | 單元 7 |
| Workflow | GitHub Actions | .github/workflows/*.yml 定義 CI/CD | 單元 7 |
| Manifest | Kubernetes | apiVersion / kind / metadata / spec 四個頂層欄位 | 單元 7 |
| safe_load | Safe Load | 只載入純資料，避免任意物件建構的攻擊 | 單元 8 |
| yamllint | yamllint | CLI 檢查縮排、行長、重複鍵 | 單元 8 |
| yq | yq | 命令列讀取/修改 YAML，類似 jq | 單元 8 |