jq怎么数组转json

轻松：使用jq将数组转换为JSON格式

在处理数据时,我们经常需要将不同形式的数据结构转换为JSON格式。jq 是一个轻量级且强大的命令行JSON处理器，它能够帮助我们轻松地完成各种JSON数据的转换和查询任务，将数组（在jq中通常指代数组的字面量或由jq操作生成的数组）转换为JSON字符串，是jq一个非常基础且常用的功能。

本文将详细介绍如何使用jq将数组转换为JSON，包括基本语法、不同场景下的示例以及一些实用技巧。

jq简介及其数组概念

简单回顾一下jq。jq就像sed之于文本，awk之于表格，它专门用于处理JSON数据，它的输入通常是JSON格式的文本，输出也是JSON格式的文本。

在jq中，数组（Array）是由方括号 [] 包围的、由逗号分隔的值的有序集合。[1, 2, "three", {"key": "value"}] 就是一个JSON数组。

当我们说“数组转JSON”时，在jq的上下文中，通常指的是：

jq中最直接的方式就是使用数组字面量，如果你只是想创建一个固定的数组并将其转换为JSON字符串，只需要在jq命令中写出这个数组即可。

语法：

jq -n '[元素1, 元素2, ...]'

-n (或 --null-input)：表示不从标准输入读取任何数据，而是使用jq提供的空输入null作为初始值，这对于直接输出静态数据非常有用。
[元素1, 元素2, ...]：这就是我们要创建的数组，元素可以是字符串、数字、布尔值、对象，甚至是嵌套的数组。

示例1：创建简单的数值和字符串数组 假设我们想创建一个包含几个数字的数组 [1, 2, 3]。

$ jq -n '[1, 2, 3]'

输出：

[1, 2, 3]

示例2：创建包含混合类型的数组 数组中可以包含不同类型的数据。

$ jq -n '["apple", 42, true, null]'

输出：

["apple", 42, true, null]

示例3：创建包含嵌套对象和数组的数组 jq支持复杂的嵌套结构。

$ jq -n '[{"name": "Alice", "age": 30}, ["nested", "array"], false]'

输出：

[{"name": "Alice", "age": 30}, ["nested", "array"], false]

更常见的情况是,我们并非凭空创建数组，而是需要从现有的数据源（如文件、其他命令的输出）中提取信息，构建成一个数组，然后将其转换为JSON。

语法：

some_command_or_data_source | jq '[...表达式...]'

示例4：将文件中的每行转换为一个数组元素 假设我们有一个文件 fruits.txt如下：

apple
banana
orange

我们想读取这个文件,将每一行作为一个字符串元素，转换为一个JSON数组 ["apple", "banana", "orange"]。

可以使用 inputs 生成器（在 6+ 版本中常用）结合 split 或直接处理：

# 方法一：使用 -R 和 split (适用于每行一个元素)
$ jq -R -s 'split("\n") | .[0:-1]' fruits.txt

解释：

-R (或 --raw-input)：将每行输入作为原始字符串处理，而不是JSON。
-s (或 --slurp)：将所有输入读取到一个大的数组中，每个元素是输入的一行，对于 fruits.txt，它会先变成 ["apple\n", "banana\n", "orange\n"]。
split("\n")：按换行符分割字符串，但通常会在末尾保留一个空字符串。
.[0:-1]：切片操作，去掉最后一个元素（通常是空字符串）。

输出：

["apple", "banana", "orange"]

更简洁的方法（推荐）：

# 方法二：使用 inputs 和 -n
$ jq -n 'inputs' fruits.txt

inputs 会逐行读取输入（当与 -n 一起使用时），并将其作为流处理，这里jq会自动将其包装成一个数组。

示例5：从另一个JSON中提取数据生成数组 假设有一个 users.json 文件，内容如下：

[
  {"id": 1, "name": "Tom"},
  {"id": 2, "name": "Jerry"},
  {"id": 3, "name": "Spike"}
]

我们想提取所有用户的 name，组成一个新数组 ["Tom", "Jerry", " Spike"]。

$ jq '.[].name' users.json

这个命令会输出：

"Tom"
"Jerry"
"Spike"

这实际上是三个独立的JSON字符串,如果希望它们成为一个数组，可以使用 [] 将其包裹：

$ jq '[.[].name]' users.json

输出：

["Tom", "Jerry", "Spike"]

格式化输出（美化JSON）：默认情况下，jq的输出是紧凑的，如果你希望输出格式化的、易读的JSON，可以使用 -S (或 --sort-keys) 选项，它会按键名排序并美化格式。
```
$ jq -S -n '[{"b": 2, "a": 1}, 3]'
```
输出：
```
[
  {
    "a": 1,
    "b": 2
  },
  3
]
```
处理空数组： jq可以正确处理空数组 []。
```
$ jq -n '[]'
```
输出：
```
[]
```
数组与JSON字符串的关系： jq的核心就是处理JSON数据，当你使用jq输出一个数组时，其本身就是JSON格式的一个JSON数组（Array）类型，如果你需要的是一个JSON字符串（即整个数组被双引号包围，如 "[1, 2, 3]"），则需要使用 @json 过滤器或 tojson 函数。
- tojson：将值转换为JSON字符串。
```
$ jq -n '[1, 2, 3] | tojson'
```
  输出：
```
[1, 2, 3]
```
  看起来一样,但注意，这里的输出在jq看来是一个JSON 字符串是数组，如果用在更复杂的表达式中，区别会显现。
- @json：通常用于格式化字符串中的变量为JSON。
```
$ jq -n '"My array is: \([1, 2, 3] | @json)"'
```
  输出：
```
"My array is: [1, 2, 3]"
```
  通常情况下,我们需要的“JSON数组”就是jq直接输出的那种形式，无需额外转换。