json_数组转表格

函数名：json_数组转表格 / json_ArrayToTable

功能描述

将 JSON 数组转换为表格数据，可选择横向（1 行多列）或纵向（1 列多行）输出，适用于快速拆解数组内容。

会员等级：🟢 免费版（Free）

语法

=json_数组转表格(JSON数组/文件路径, 横向输出)

参数

参数名	类型	必填	默认值	说明
JSON数组/文件路径	String	是	-	JSON 数组字符串，或 JSON 文件的绝对/相对路径。文件存在时按文件读取
横向输出	Boolean	否	TRUE	TRUE 为横向输出（1 行 N 列），FALSE 为纵向输出（N 行 1 列）

返回值

Object[,] - 二维数组。横向输出为 1×N，纵向输出为 N×1，每个元素为数组项的字符串形式。

使用示例

横向展开数值数组

公式：

=json_数组转表格("[1,2,3]", TRUE)

结果：

1 | 2 | 3

纵向展开数值数组

公式：

=json_数组转表格("[1,2,3]", FALSE)

结果：

1
2
3

字符串数组展开

公式：

=json_数组转表格("[\"苹果\",\"香蕉\",\"梨\"]", TRUE)

结果：

苹果 | 香蕉 | 梨

技术说明

• 使用 JArray.Parse 解析 JSON 数组字符串。
• 当输入为已存在的文件路径时，使用 File.ReadAllText 以系统默认编码（System.Text.Encoding.Default）读取。
• 横向输出构造 1×N 二维数组，纵向输出构造 N×1 二维数组；每个元素调用 ToString() 转为字符串。
• 结果为动态数组，会自动溢出到相邻单元格。

错误处理

错误场景	返回值
无效的 JSON 数组或解析异常	无效的JSON数组（单单元格）