jsonpath 是什么
jsonpath 是一种按路径从结构化数据里取值的表达式。kubectl 接受它作为输出格式，用来从查询结果中精确提取某个字段：批量取对象名称、查容器使用的镜像、取 Pod 所在节点、读服务的虚拟地址，都是它的常见用法。它的价值在于把「人眼看的表格」变成「脚本能直接消费的值」。
单对象与列表的写法差别
查询单个对象时，路径从字段开始；查询列表时，结果被放在条目数组里，需要先进入该数组再逐项取值。要输出多列或带分隔符的成对数据，就用循环语法在每一项之间插入分隔符。写错层级不会报错，而是静默输出空值，这一点最容易埋下隐患。
基本信息
| 适用环境 | 任何 Kubernetes 发行版，所有可输出结构化数据的资源都支持 |
|---|---|
| 语法 | kubectl get <资源> -o jsonpath='{表达式}' |
| 单对象写法 | 直接从字段名开始，如取节点的名称 |
| 列表写法 | 先进入条目数组，再逐项取值 |
| 循环输出 | 用循环与结束标记，在项之间插入分隔符 |
| 典型风险 | 层级写错时输出空值而不报错 |
典型使用场景
- 批量取名称：拿到一组 Pod 名称交给下一个命令处理
- 查镜像版本：确认某个负载当前运行的是哪个镜像标签
- 取节点归属：判断某个实例落在哪台机器上
- 读取地址：取出服务的虚拟地址或 Pod 的地址用于连通性测试
- 提取状态字段：从状态结构里取相位或副本数量做条件判断
- 生成报表：批量提取字段拼成表格供审计使用
常用示例
常用示例
kubectl get pods -o jsonpath='{.items[*].metadata.name}' # 所有 Pod 名称
kubectl get pod web-x -o jsonpath='{.spec.nodeName}' # 所在节点
kubectl get pod web-x -o jsonpath='{.status.phase}' # 当前相位
kubectl get deploy web -o jsonpath='{.spec.template.spec.containers[0].image}' # 镜像
kubectl get svc web -o jsonpath='{.spec.clusterIP}' # 服务虚拟地址
kubectl get pods -o jsonpath='{range .items[*]}{.metadata.name}{"\t"}{.status.podIP}{"\n"}{end}' # 名称与地址成对输出常用表达式元素
| 元素 | 含义 | 例子场景 |
|---|---|---|
| 字段名 | 取某个属性 | 取对象名称 |
| 中括号星号 | 数组里所有元素 | 取列表中每一项 |
| 中括号数字 | 数组中的第几个元素 | 取容器列表的第一项 |
| 范围内的循环 | 逐项遍历并拼接输出 | 生成多列文本 |
| 引号内字符 | 插入制表或换行 | 让输出便于后续处理 |
路径层级要以对象结构为准，列表查询用条目数组、单对象查询用具体字段，混淆两者会得到空结果。
在脚本里尽量用单引号包裹表达式，避免特殊字符被外层解释器提前展开。