JSON-to-Excel v2.0.0发布，可以在Excel内部，把JSON转换成Excel格式，嵌套的JSON也能转

本文是JSON-to-Excel插件的官方文档 https://json-to-excel.wtsolutions.cn 简化浓缩翻译的中文版，仅供参考。详细的还请查看官方文档。

插件简介

JSON-to-Excel是一款强大的Microsoft Excel插件，专门用于将JSON数据转换为Excel表格格式。这款插件能够帮助用户轻松处理和转换JSON数据，提高数据处理效率。

插件版本

20250228发布v2.0.0版本。

系统要求

本插件支持以下Excel版本：

Excel 2013 Service Pack 1及更高版本
Excel 2016 for Mac
Excel 2016及更高版本
Excel Online
Office 365

安装步骤

打开Excel 2013/2016、Excel Online或Office 365中的新工作表
在主页标签或插入标签中找到加载项
在搜索框中输入"JSON-to-Excel"
按照屏幕上的说明安装插件
安装完成后，您将在主页标签中看到JSON-to-Excel按钮
点击主页标签 > JSON to Excel > Convert即可开始使用

使用方法

准备您的JSON数据
将JSON数据填入JSON-to-Excel的文本框中
选择转换模式
点击"Go"按钮开始转换

JSON格式要求

基本格式

输入的JSON数据必须是包含对象的有效JSON数组，数组中的每个对象将转换为Excel表格中的一行数据。

格式规则

必须使用方括号\[\]包裹，表示数组
必须至少包含一个对象{}
每个对象必须至少包含一个属性

支持的数据类型

字符串："text"
数字：123，45.67
布尔值：true，false
空值：null（将在Excel中转换为空单元格）
数组： $1, 2, 3$ （将在Excel中转换为字符串，如" $1,2,3$ "）
对象：{"x": 1}
- 在平铺模式下将转换为字符串，如'{"x": 1}'
- 在嵌套模式下将被展开

转换模式

1. 平铺JSON模式（Flat JSON Mode）

适用于没有嵌套结构的简单JSON对象
每个属性将成为Excel中的一列

2. 嵌套JSON模式（Nested JSON Mode）

适用于具有嵌套结构的JSON对象
嵌套属性将使用点号表示法展开
例如：contact.email将成为一个列名

使用示例

示例JSON数据

json 复制代码

[
    {
        "name": "John",
        "contact": {
            "email": "john@example.com",
            "phone": "1234567890"
        }
    },
    {
        "name": "Jane",
        "contact": {
            "email": "jane@example.com",
            "phone": "0987654321"
        }
    }
]

转换结果

平铺模式下的结果

name	contact
John	{"email":"john@example.com","phone":"1234567890"}
Jane	{"email":"jane@example.com","phone":"0987654321"}

嵌套模式下的结果

name	contact.email	contact.phone
John	john@example.com	1234567890
Jane	jane@example.com	987654321

使用限制

每次转换最多支持1000个对象（行）
每个数据集最多支持100个唯一属性（列）
值中的数组将在Excel中转换为字符串

常见错误处理

无效的JSON格式

当插件提示JSON无效时，请按以下步骤检查：

使用在线JSON验证工具进行预检查
确保JSON数据符合上述格式要求

列数过多错误

如果出现"too many columns"错误，表示单个元素中的键值对数量过多，请检查并调整数据结构。