如何将长jq查询字符串拆分为多行？反斜杠换行失效怎么办？

我之前也碰到过这个问题！用反斜杠换行经常踩坑——要么是不小心在反斜杠后面加了空格，要么是shell的换行处理破坏了jq的语法结构。给你几个靠谱的解决办法，按使用场景选就行：

1. 用单引号包裹查询，直接换行（最推荐） #

jq本身完全支持多行语法，只要用单引号把整个查询包起来，直接换行就行，不需要任何反斜杠。shell会把单引号里的换行原封不动传给jq，既美观又不容易出错：

jq '
  .items[]
  | select(.name != null)
  | {id: .id, name: .name}
' input.json

这种方式适合大多数场景，还能在查询里加注释（只要注释单独占一行，用#开头）：

jq '
  # 筛选出非空名称的条目
  .items[]
  | select(.name != null)
  # 只保留id和name字段
  | {id: .id, name: .name}
' input.json

2. 使用Here-Doc（适合复杂查询或需要变量传递） #

如果你的查询特别长，或者需要结合shell变量，用Here-Doc是最佳选择。它能让你像写脚本一样写jq查询，还能避免shell解析查询里的特殊字符：

jq -n --arg input_path "/path/to/data.json" -f - <<'EOF'
  # 读取传入的文件路径并解析JSON
  $input_path
  | fromjson
  # 筛选状态为active的数据
  | .data[]
  | select(.status == "active")
EOF

这里的<<'EOF'用单引号包裹分界符，能防止shell解析查询里的变量（比如$input_path只会被jq识别，不会被shell提前替换）；如果需要shell解析变量，去掉单引号就行。

3. 一定要用反斜杠？注意这一点！ #

如果你坚持要用反斜杠换行，必须保证反斜杠后面没有任何空格、制表符或其他字符，而且换行的位置要符合jq语法（比如在管道符|、逗号,、大括号{等符号前后）：

❌ 错误示例（反斜杠后有空格）：

jq '.items[] \ 
  | select(.name != null)' input.json

✅ 正确示例：

jq '.items[] \
| select(.name != null)' input.json

不过这种方式不推荐，因为很容易不小心加空格导致失效，而且没法加注释。

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