---
title: JSON转CSV转换器
description: "逐步指南，使用 Sheetize 将 JSON 数据转换为 CSV 文件，适用于数据分析、报告以及与电子表格工具的集成。"
weight: 2
categories: "开发者指南"
draft: false
---

**针对 .NET 的 Sheetize JSON转CSV转换器** 提供了一个简单却强大的 API，能够将结构化的 JSON 文档转化为扁平的 CSV 表格。无论是处理 API 响应、日志文件，还是配置数据，Sheetize 都能解析 JSON 层级结构、展开嵌套对象，并生成符合标准的 CSV，直接供 Excel、PowerBI 或任意数据管道使用。

## 主要特性

### 将 JSON 转为 CSV
生成 JSON 数组或对象的 CSV 表示，支持可配置的分隔符、表头生成以及类型处理。

### 可定制的展开方式
通过点号表示法或自定义列映射，控制嵌套对象和数组的展开方式，确保输出符合你的模式需求。

### 流式处理支持
对大文件采用流式方式处理，降低内存占用，适合大数据场景。

## 详细操作步骤

### JSON → CSV 工作流
使用 Sheetize 将 JSON 文件转换为 CSV，按以下步骤操作：

1. **初始化转换器**：创建 `JsonConverter` 实例。  
2. **配置选项**：设置 `JsonSaveOptions`，定义分隔符、是否包含表头行以及嵌套结构的处理方式。  
3. **指定文件路径**：提供源 JSON 路径和目标 CSV 保存位置。  
4. **执行转换**：调用 `Process` 并传入准备好的加载和保存选项。

**示例 – 带表头且使用分号分隔符的 JSON 转 CSV**

```csharp
using Sheetize;

var loadOptions = new LoadOptions
{
    InputFile = @"D:\Data\input.json"
};

var saveOptions = new JsonSaveOptions
{
    OutputFile = @"D:\Data\output.csv"
};

JsonConverter.Process(loadOptions, saveOptions);

扩展格式支持

  • Sheetize 还能将 CSV 转回 JSON，实现数据的往返转换。
  • 除 CSV 外，库还支持导出为 TSV、Pipe 分隔文件，以及直接生成 DataTable 对象供内存中处理。
  • 将 JSON→CSV 转换与 HTML ↔ XLSX 工具结合，可构建端到端的报告流水线，例如：JSON → CSV → XLSX → HTML。

有了这些功能，Sheetize 让 JSON 转 CSV 的过程变得轻而易举，无论是一次性脚本还是生产级服务，都能轻松胜任。

 中文