如何自动获取YAML文件的有效键以适配yq/jq语法？

问题场景 #

我用以下命令将YAML转为属性格式：

echo "apiVersion: v1
kind: Node
metadata:
  name: host-cluster-control-plane-64j47
  labels:
    beta.kubernetes.io/arch: amd64
" | yq -o p

得到的结果是：

apiVersion = v1
kind = Node
metadata.name = host-cluster-control-plane-64j47
metadata.labels.beta.kubernetes.io/arch = amd64

这个输出接近需求，但生成的键路径无法直接用于yq取值——比如metadata.labels.beta.kubernetes.io/arch包含特殊字符/，必须写成metadata.labels["beta.kubernetes.io/arch"]才能正常取值。我需要一种自动化方法，从YAML中提取可直接用于yq/jq的合法键路径，期望输出格式如下：

apiVersion = v1
kind = Node
metadata.name = host-cluster-control-plane-64j47
metadata.labels["beta.kubernetes.io/arch"] = amd64

解决方案（基于mikefarah/yq v4+） #

可以通过yq的递归遍历+自定义路径构建逻辑，自动为含特殊字符的键添加方括号引号：

echo "apiVersion: v1
kind: Node
metadata:
  name: host-cluster-control-plane-64j47
  labels:
    beta.kubernetes.io/arch: amd64
" | yq '
  def buildPath($path):
    reduce $path as $item ("";
      . + (if . == "" then "" else "." end) +
      (if $item | test("^[a-zA-Z_][a-zA-Z0-9_]*$") then $item else "[\"" + $item + "\"]" end)
    );
  .. | select(leaf_node) | buildPath(path) + " = " + (tostring)
'

执行后会直接输出符合要求的格式，生成的键路径可以直接复制用于yq取值，比如：

k get nodes -o yaml | yq '.items[].metadata.labels["beta.kubernetes.io/arch"]'

逻辑说明 #

1. buildPath自定义函数：遍历节点路径的每一段，判断键名是否符合标识符规则（字母/下划线开头，后续为字母/数字/下划线），不符合规则的键会自动用["key"]格式包裹。
2. .. | select(leaf_node)：递归遍历YAML的所有叶子节点（即最终的取值节点）。
3. path：获取当前叶子节点的完整路径数组，传给buildPath生成合法的路径字符串。
4. tostring：将节点值转为字符串，保证输出格式统一。

如果需要用jq处理（可先将YAML转JSON），逻辑类似：

echo "apiVersion: v1
kind: Node
metadata:
  name: host-cluster-control-plane-64j47
  labels:
    beta.kubernetes.io/arch: amd64
" | yq -o json | jq '
  def buildPath($path):
    reduce $path[] as $item ("";
      . + (if . == "" then "" else "." end) +
      (if $item | test("^[a-zA-Z_][a-zA-Z0-9_]*$") then $item else "[\"" + $item + "\"]" end)
    );
  leaf_paths as $p | buildPath($p) + " = " + (getpath($p) | tostring)
'

内容的提问来源于stack exchange，提问作者guettli