提取JSON字段需用.key并加-r去引号，嵌套用点号链、数组必须[]展开，过滤用select()配合类型转换，传参用--arg防注入，空值用//兜底或select(.!=null)跳过。
提取单个字段用 .key，但必须加 -r 才能直接给脚本用
默认输出带双引号，比如 jq '.name' 处理 {"name": "Alice"} 得到的是 "Alice"，不是 Alice。后续接 grep、if [ "$x" = "Alice" ] 会失败。
加 -r 是硬性要求：jq -r '.name' 输出裸字符串 Alice，可直接赋值给 shell 变量或参与条件判断。
- 字段不存在时，默认输出
null（字符串），不是空行；想跳过这种行，得加| select(. != null) - 想兜底给默认值，用
// "default"：例如jq -r '.email // "no-email@local" - 表达式一定要用单引号包裹，
jq .name会被 shell 拆成两个参数，报错jq: error: name/0 is not defined
嵌套字段和数组遍历怎么写才不漏数据
点号链式访问支持任意深度：.user.profile.avatar、.metadata.labels["app"] 都合法。数组则必须显式展开——.items[] 表示“把 items 数组每个元素都喂给后面的过滤器”，不是只取第一个。
常见错误是漏掉 []：比如 jq '.items.name' 对 {"items": [{"name":"a"},{"name":"b"}]} 只返回 null，因为 .items 是数组，不能直接点 .name。
- 取数组第一个元素：
.items[0].name - 取所有元素的某个字段：
.items[].name（配合-r会每行一个值） - 要保留原始 JSON 结构（比如只改 name 字段），别用
-r，否则输出变纯文本，没法再 pipe 给下一个jq - 如果数组里有
null元素，.items[].name会输出对应数量的null行，需用select(.name != null)过滤
select() 过滤时容易踩的类型坑
select() 里写的条件，字段值类型必须匹配。比如 .port == 8080 在 port 是字符串时永远为 false；得先转类型：(.port | tonumber) == 8080。
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
更隐蔽的是字段存在性判断：用 has("field") 比 .field != null 更准，因为前者能区分“字段不存在”和“字段值为 null”两种情况。
- 多条件用
and/or，不要用&&或||（那是 shell 的） - 字符串比较注意大小写：
.status | ascii_downcase == "running" - 正则匹配用
test("pattern")，比如.name | test("^admin.*") - 避免在
select()外层再套.[]，否则可能重复展开——先.items[]再| select(...)才是标准顺序
从外部传变量进 jq 表达式用 --arg，别拼接字符串
shell 变量插进 jq 里，最安全的方式是用 --arg 定义 jq 内部变量，再在表达式里用 $varname 引用。手动拼接字符串（如 jq ".name == \"$name\""）极易被特殊字符破坏，还可能引入注入风险。
例如查登录名：login_id="opsnot"，正确写法是：
jq --arg uid "$login_id" '.[] | select(.loginId == $uid) | .name' users.json
-
--arg传入的值自动转为字符串；若要传 JSON 结构（如对象或数组），改用--argjson - 变量名不能含短横线（
-），--arg my-id "x"会解析失败，改用my_id - 多个变量就重复写
--arg：--arg a "1" --arg b "2" - 如果输入是空文件或无匹配项，jq 默认输出空，不会报错——这点常被忽略，建议用
||在 shell 层做 fallback
实际用得多的其实是组合：比如 kubectl get pods -o json | jq -r '.items[] | select(.status.phase == "Running") | .metadata.name'，它串起了结构访问、数组展开、条件过滤、字段提取和去引号五步。真正卡住人的，往往不是语法记不住，而是某一层没展开、某个 null 没处理、或者少了个 -r 导致后续命令全崩。
