1. 简介

English

JSON to Excel 是一个 Microsoft Excel 加载项或Web 应用程序，可以将 JSON 转换为 Excel。平坦/嵌套的 JSON 都可以转换。

2. 要求

选项 1. 在 Web 浏览器中加载 JSON to Excel

支持 JavaScript 的 Web 浏览器，例如 Google Chrome、Mozilla Firefox、Safari 或 Microsoft Edge。

选项 2. 在 Excel 中旁加载 JSON to Excel（推荐）

Excel 2013 Service Pack 1 或更高版本，
Mac 版 Excel 2016，
Excel 2016 或更高版本，
Excel Online，
Office 365 等。

3. 快速入门

本快速入门适用于 v 3.0.0

3.1 （旁）加载 JSON to Excel

选项 1. 在 Web 浏览器中加载 JSON to Excel

打开支持 JavaScript 的 Web 浏览器，例如 Google Chrome、Mozilla Firefox、Safari 或 Microsoft Edge。
在您的 Web 浏览器中打开以下 URL：https://s.wtsolutions.cn/json-to-excel.html

选项 2. 在 Excel 中旁加载 JSON to Excel（推荐）

在 Excel 2013/2016 或 Excel Online 或 Office 365 中打开一个新的工作表。
主页选项卡或插入选项卡 > 加载项
在搜索框中，输入“JSON to Excel”
按照屏幕上的说明安装加载项，您将在主页选项卡中看到一个名为 JSON-to-Excel 的按钮。
主页选项卡 > JSON to Excel > 转换
现在您已准备好使用此加载项。

3.2 使用 JSON to Excel

准备您的 JSON 数据
在设置框中，选择转换模式等。
加载您的 JSON 数据（选择以下两种方式之一）
1. 在文本区域中复制并粘贴您的 JSON 数据，或者
2. 单击“加载 JSON 文件”文件选择器，并从本地计算机中选择您的 JSON 文件，用于批量处理（专业功能），一次最多可加载 20 个文件。
单击“Go”按钮

限制

每次转换最多 1000 个对象（行）
每个数据集最多 100 个唯一属性（列）
值中的数组将转换为 Excel 中的字符串
一次最多可转换 20 个加载的本地 JSON 文件（专业功能）

3.3 转换设置

转换模式

有两种转换模式：平面 JSON 模式和嵌套 JSON 模式。

请先参考下面的示例，以帮助您理解这两种模式

平面 JSON 模式
- 用于没有嵌套结构的简单 JSON 对象
- 每个属性都成为 Excel 中的一列
嵌套 JSON 模式
- 用于具有嵌套结构的 JSON 对象
- 嵌套属性使用点/下划线/双下划线/斜杠分隔符进行展平
- 默认情况下转换无限深度。使用专业功能中的“最大嵌套深度”设置自定义嵌套对象的最大深度（1 到 20，或无限）。

嵌套分隔符

用于分隔 Excel 输出中嵌套属性的分隔符。

点 (.)
下划线 (_) [专业功能]
双下划线 (__) [专业功能]
斜杠 (/) [专业功能]

最大嵌套深度

要展平的嵌套对象的最大深度。

无限
1 到 20 [专业功能]

3.4 加载 JSON 数据

有两种加载 JSON 数据的方式：

在文本区域中复制并粘贴您的 JSON 数据
单击“加载 JSON 文件”文件选择器，并从本地计算机中选择您的 JSON 文件，用于批量处理（专业功能），一次最多可加载 20 个文件。

可接受的 JSON 格式

所需格式

输入必须是包含对象的有效 JSON 数组。数组中的每个对象代表 Excel 输出中的一行。

[
    {"property1": "value1", "property2": "value2", ...},
    {"property1": "value3", "property2": "value4", ...}
]

JSON 格式规则

必须用方括号 [] 包裹，作为数组
必须至少包含一个对象 {}
每个对象必须至少有一个属性

支持的值类型

字符串: "text"
数字: 123 , 45.67
布尔值: true , false
空值: null
- 将转换为 Excel 中的空白单元格
数组: [1, 2, 3]
- 将转换为 Excel 中的字符串，如 "[1,2,3]"
对象: {"x": 1}
- 如果选择平面模式，将转换为 Excel 中的字符串，如 '{"x": 1}'
- 如果选择嵌套模式，将展平

4. 示例

4.1 有效 JSON 示例

// 简单，一个平面对象
{"name": "John", "age": 30}

// 简单，平面对象
[
    {"name": "John", "age": 30},
    {"name": "Jane", "age": 25}
]

// 具有不同属性的对象
[
    {"name": "John", "age": 30},
    {"name": "Jane", "city": "New York"}
]

// 具有嵌套结构的对象（使用嵌套 JSON 模式）
// 使用专业功能中的“嵌套分隔符”设置自定义分隔符（点、下划线、斜杠）
// 使用专业功能中的“最大嵌套深度”设置自定义嵌套对象的最大深度（1 到 20，或无限）
[
    {
        "name": "John",
        "contact": {
            "email": "john@example.com",
            "phone": "1234567890"
        }
    },
    {
        "name": "Jane",
        "contact": {
            "email": "jane@example.com",
            "phone": "0987654321"
        }
    }
]

4.2 无效 JSON 示例

// 未用数组包裹
{"name": "John"},{"name": "Lily", "age": 30}

// 空数组
[]

// 包含非对象元素的数组
[1, 2, 3]
["a", "b", "c"]

// 包含空对象的数组
[{}]

// 包含 null 的数组
[null]

// 混合类型的数组
[{"name": "John"}, "text"]

4.3 转换示例

JSON 到 Excel 示例

输入

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

输出

平面 JSON 模式

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

嵌套 JSON 模式

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

使用专业功能中的“嵌套分隔符”设置自定义分隔符（点、下划线、双下划线、斜杠）
使用专业功能中的“最大嵌套深度”设置自定义嵌套对象的最大深度（1 到 20，或无限）

5. 错误

5.1 无效 JSON

当 JSON to Excel 弹出无效 JSON 的错误提示时，表示 JSON 不符合 JSON 架构。

加载项检查

加载项将检查您的 JSON 数据是否符合上述可接受的 JSON 格式要求。如果出错，将显示错误消息。

5.2 列数过多

当您弹出列数过多错误时，表示您在一个元素中包含过多的键值对。

一个元素包含两个键值对，

    {
        "name":"Lily",
        "age":22
    }

并且加载项现在最多只能接受 100 个键值对。

he-yang/JSON-to-Excel-zh-CN