使用jq处理多个同结构JSON文件输出CSV时如何避免重复输出表头

首先明确：jq本身没有内置input_filenames[0]这类可读取全部输入文件名的全局属性，你之前硬编码首个文件名的写法，是因为没有利用到jq的全局状态存储能力，完全可以不写死文件名实现只输出一次表头的效果。

核心实现思路 #

jq支持通过$ENV修改跨文件处理的全局状态，不需要依赖具体文件名做判断，只需要设置一个“表头是否已经输出”的标记即可：

• 脚本初始化阶段，把全局标记表头已输出设为假
• 每处理完一个JSON文件的行列映射逻辑，先检查这个标记：
  • 如果标记为假：先输出一次列名作为CSV表头，再把标记改成真，最后输出当前文件的所有数据行
  • 如果标记为真：直接输出当前文件的所有数据行，不重复输出表头

对应的jq脚本逻辑替换示例：

# 初始化全局标记
($ENV.csv_header_emitted = false)
| (map(keys) | add | unique) as $cols
| map(. as $row | $cols | map($row[.])) as $rows
# 按标记判断是否输出表头
| if $ENV.csv_header_emitted == false then
    # 第一次输出：更新标记，输出表头+当前数据行
    ($ENV.csv_header_emitted = true), $cols, $rows[]
  else
    # 后续输出：仅输出数据行
    $rows[]
  end
| @csv

更稳定的工程化替代方案 #

如果担心jq的全局状态在不同版本下的兼容性问题，可以用两阶段输出的方式，完全绕开内部状态判断：

1. 单独对第一个输入文件执行jq命令，仅输出提取到的列名作为CSV表头
2. 对所有输入文件执行jq命令，仅输出每个文件解析后的数据行，不生成表头
3. 将两个步骤的输出流顺次拼接，就能得到带唯一表头的完整CSV，不存在重复表头的风险

这种方式完全不依赖jq的内部状态逻辑，即使输入文件顺序调整、文件名修改也不会出问题，鲁棒性更强。

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