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

安装步骤

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

使用方法

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

JSON格式要求

基本格式

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

格式规则

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

支持的数据类型

• 字符串：“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数据

[
    {
        "name": "John",
        "contact": {
            "email": "[email protected]",
            "phone": "1234567890"
        }
    },
    {
        "name": "Jane",
        "contact": {
            "email": "[email protected]",
            "phone": "0987654321"
        }
    }
]

转换结果

平铺模式下的结果

name	contact
John	{“email”:“[email protected]”,“phone”:“1234567890”}
Jane	{“email”:“[email protected]”,“phone”:“0987654321”}

嵌套模式下的结果

name	contact.email	contact.phone
John	[email protected]	1234567890
Jane	[email protected]	987654321

使用限制

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

常见错误处理

无效的JSON格式

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

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

列数过多错误

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

更多内容

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