2026-05-19 · 约 1 分钟阅读
配置文件中的 YAML 与 JSON
以运行时消费的格式为准；仅在双方约定清晰时再转换。
YAMLJSON配置
要点
- YAML 注释与锚点无法无损往返 JSON。
- 转换后提交前务必校验 JSON。
如何选择格式
YAML 适合手写带注释的配置；JSON 适合严格解析与生成物。
在仓库边界转换（人读 YAML → 机读 JSON），不要每次保存都转。
安全转换流程
粘贴到 YAML ⇄ JSON，检查 diff，再对结果运行 JSON Validator。
若是 OpenAPI 文档，继续用 OpenAPI Validator 做结构检查。
常见问题
转换会改变数字或布尔值吗？
会——引号与类型很关键。请 diff 输出并在 CI 跑解析器。
K8s 用 YAML，要存 JSON 吗？
Git 中保留 YAML；仅当下游工具要求时再生成 JSON。