核心用法
本技能系统梳理 YAML 语法规范，聚焦跨解析器、跨版本的可靠编写实践。内容覆盖六大模块：
1. 类型强制陷阱 — 明确布尔值、空值、数字、特殊浮点的隐式转换规则，提供带引号的防御性写法
2. 缩进与结构 — 强制空格缩进、2空格惯例、序列项 - 的缩进计算逻辑
3. 字符串处理 — 危险字符（: , #, @, ` `, , &` 等）的触发场景与转义策略
4. 多行字符串 — | 保留换行与 > 折叠换行的区别，以及尾随换行符控制符（-/+）的精确语义
5. 锚点与别名 — &name 定义锚点、*name 引用别名，注意别名不可覆盖锚点值
6. 兼容性要点 — YAML 1.1/1.2 差异（布尔词、八进制语法）、JSON 子集关系、解析器限制
显著优点
- 权威性：直接映射 YAML 1.2 规范与主流解析器（PyYAML、ruamel.yaml、go-yaml）行为差异
- 实用性：每个规则附带具体错误示例与修正代码，可立即落地
- 风险前置：类型强制陷阱清单覆盖 90% 以上的生产环境 YAML 解析 bug
- 跨平台：适用于 CI/CD 配置、Kubernetes 清单、Ansible Playbook、GitHub Actions 等全场景
潜在局限
- 版本碎片化：YAML 1.1 与 1.2 的布尔/八进制行为差异未在技能内提供自动检测工具，需人工确认目标解析器版本
- 解析器特异性：部分规则（如嵌套深度限制、文件大小限制）依赖具体实现，技能仅作提示无量化标准
- 无 schema 验证：技能聚焦语法正确性，不涉及 YAML Schema 或 JSON Schema 校验
适合人群
- DevOps/SRE 工程师编写 pipeline 与编排配置
- 后端开发者设计 API 配置接口
- 基础设施即代码 (IaC) 实践者
- 技术写作人员编写技术文档示例
常规风险
| 风险等级 | 场景 | 防御措施 |
|---------|------|---------|
| 高 | 未引号的 `yes`/`no`/`on`/`off` 被解析为布尔值 | 字符串强制加引号 `"yes"` |
| 高 | 版本号 `1.0` 被解析为浮点数 `1` | 强制引号 `"1.0"` |
| 中 | 八进制 `010` 在 YAML 1.1 中解析为 `8` | 使用 `0o10` 或引号 `"010"` |
| 中 | 国家代码 `NO` 被解析为 `false` | 所有国家代码强制引号 |
| 低 | 多行块尾随换行符不可控 | 显式使用 `|+` / `|-` 控制符 |
综合评估
YAML 作为数据序列化格式的核心痛点在于「看起来直观，解析行为却高度隐含」。本技能通过结构化的陷阱清单与防御性编码规范，将隐性风险显性化，是生产级 YAML 编写的必备参考。建议配合具体解析器的版本测试（如 Python 的 PyYAML 默认 1.1，ruamel.yaml 支持 1.2）形成完整工作流。