yq

YAML/JSON/XML 处理器，语法类似 jq

补充说明

yq 有 Mike Farah 的 Go 版和 Python 版，两者语法不同；下面以 Go 版（mikefarah/yq）为例。它适合读写 Kubernetes 清单、CI 配置和多文档 YAML。

常用示例

yq '.spec.replicas' deploy.yaml
yq -i '.metadata.labels.env = "prod"' deploy.yaml
yq -o=json '.' config.yaml
yq eval-all 'select(.kind == "Deployment")' manifests/*.yaml

易错点与排错

• 先确认是 Go 版还是 Python 版；yq --version 和语法差异很大。
• -i 是原地修改；改前备份，或用 -o 先看输出。
• YAML 注释、锚点/别名在写回时可能丢失；需要保留时先测试。
• 多文档（---）用 eval-all；普通 . 只处理第一份。
• 字符串含特殊字符时要加引号；--arg 比拼接更安全。
• 布尔/数字/null 的 YAML 表示要符合目标工具；"yes" 和 yes 不同。
• 不要把 yq 当成 schema 校验器；结构校验用 kubeconform/JSON Schema。