本文是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数据
[{"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"错误，表示单个元素中的键值对数量过多，请检查并调整数据结构。
更多内容
本文是JSON-to-Excel插件的官方文档 https://json-to-excel.wtsolutions.cn 简化浓缩翻译的中文版，仅供参考。详细的还请查看官方文档。