# ExcelToJson

**Repository Path**: ideawedo/ExcelToJson

## Basic Information

- **Project Name**: ExcelToJson
- **Description**: Excel转Json工具
可生成配置加载代码
适用于Unity、Cocos Creator及Laya Air
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2023-09-13
- **Last Updated**: 2026-03-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Excel转JSON工具 (ExcelToJson)

一个基于 Unity 的 Excel 转 JSON 工具，可用于游戏开发中配置表的快速转换。

## 简介

ExcelToJson 是一款用于将 Excel 表格转换为 JSON 数据的 Unity 工具，支持同时生成多种游戏引擎（Cocos Creator、Unity、LayaBox）的运行时脚本。

## 功能特性

- **Excel 读取**：支持 .xlsx 和 .xls 格式的 Excel 文件
- **JSON 导出**：将 Excel 数据转换为 JSON 格式
- **多引擎脚本生成**：
  - Cocos Creator 2.x
  - Cocos Creator 3.x
  - Unity
  - LayaBox 2.x
- **压缩支持**：可选择是否启用数据压缩
- **项目管理**：保存和加载多个项目配置

## 项目结构

```
Assets/
├── Scripts/
│   ├── Data/           # 数据模型
│   ├── Handle/         # Excel处理和脚本生成
│   ├── Item/           # UI组件
│   ├── Scroller/       # 列表滚动组件
│   └── Tool/           # 核心工具类
├── StreamingAssets/    # 模板文件
└── Plugin/            # NPOI Excel库
```

## 使用方法

1. **选择 Excel 文件**：点击路径选择按钮，选择要转换的 Excel 文件
2. **设置输出路径**：选择 JSON 文件的输出目录
3. **选择脚本路径**（可选）：选择生成的脚本文件存放目录
4. **配置选项**：
   - 选择导出类型（JSON/脚本）
   - 选择脚本类型（CC2/CC3/Unity/Laya2）
   - 启用/禁用压缩
5. **导出**：点击导出按钮执行转换

## Excel 格式要求

Excel 文件应遵循以下格式：
- 第一行：字段名称
- 第二行：字段类型
- 第三行：字段描述（注释）
- 第四行起：数据内容

## 技术栈

- **Unity**：UI框架
- **NPOI**：Excel文件读写
- **EnhancedScroller**：列表滚动组件
- **LitJson**：JSON序列化
- **Crosstales FileBrowser**：文件浏览器

## 依赖库

- NPOI.dll
- NPOI.OOXML.dll
- NPOI.OpenXml4Net.dll
- NPOI.OpenXmlFormats.dll
- LitJson.dll
- ICSharpCode.SharpZipLib.dll

## 许可证

MIT License