# XLSX Sheet 转 JSON Schema

根据 Excel 表头与样例行推断 JSON Schema（类型/枚举/约束）

> 标准页面: https://elysiatools.com/zh/tools/xlsx-sheet-to-json-schema

- **分类:** Format Conversion

- **关键词:** xlsx, json schema, schema, inference, validation

## 概述

支持可选必填阈值、枚举阈值与样本行数量控制。

## 输入项

- **Excel 文件** (file)
- **工作表名** (text): Sheet1
- **表头行** (number)
- **采样行数** (number)
- **枚举最大去重数** (number)
- **必填阈值** (range)
- **Schema 标题** (text): SalesRecord

## 适用场景

- 需要为现有的 Excel 数据集快速生成后端数据校验规则时。
- 在进行数据迁移或 API 对接时，需要将非结构化的表格定义转化为标准 Schema 时。
- 希望通过采样数据自动识别字段枚举范围与必填项，减少手动编写 Schema 的工作量时。

## 工作原理

- 上传 Excel 文件并指定需要转换的工作表名称及表头所在行。
- 设置采样行数、枚举去重阈值及必填项判定比例等参数。
- 系统自动分析数据特征，生成包含类型、枚举约束及必填定义的 JSON Schema 文件。

## 使用案例

- 快速构建 API 接口的数据校验模型。
- 将遗留的 Excel 业务报表转化为结构化的数据库定义。
- 自动化生成前端表单验证规则。

## 常见问题

### 该工具支持哪些 Excel 格式？

支持标准的 .xlsx 和 .xls 格式的 Excel 文件。

### 如何调整必填项的判定标准？

通过调整“必填阈值”参数，系统会根据非空单元格占比来决定该字段是否在 Schema 中标记为必填。

### 枚举值是如何生成的？

系统会统计字段内的唯一值，当唯一值数量小于“枚举最大去重数”时，会自动将其识别为枚举类型。

### 采样行数对结果有什么影响？

采样行数越多，对字段类型和枚举值的推断越准确，但处理时间也会相应增加。

### 生成的 Schema 是否符合标准？

生成的 Schema 遵循标准的 JSON Schema 规范，可直接用于各类数据校验库。

## 相关工具

- [XLSX JSON 双向转换器](https://elysiatools.com/zh/tools/xlsx-json-transformer): JSON数组与Excel表格双向转换，支持嵌套对象打平与还原
- [XLSX 多 Sheet 拆分器](https://elysiatools.com/zh/tools/xlsx-multi-sheet-splitter): 将多 Sheet 工作簿拆分为多个独立文件
- [XLSX Parquet 导出器](https://elysiatools.com/zh/tools/xlsx-parquet-exporter): 将表格导出为 Parquet/NDJSON，用于大数据与数据仓库管道
- [XLSX 打印设置打包器](https://elysiatools.com/zh/tools/xlsx-print-setup-pack): 一键设置纸张、边距、缩放、重复标题行和页眉页脚
- [XLSX 区域提取器](https://elysiatools.com/zh/tools/xlsx-range-extractor): 提取指定工作表/区域/命名区域为 JSON，可保留坐标或转对象
- [XLSX 迷你图注入器](https://elysiatools.com/zh/tools/xlsx-sparkline-injector): 通过修改工作表 XML 向 Excel 单元格中插入 Sparkline 迷你图
- [Excel转JSON转换器](https://elysiatools.com/zh/tools/excel-to-json): 将Excel文件转换为JSON格式，提取第一个工作表的数据
- [XLSX 条件格式规则器](https://elysiatools.com/zh/tools/xlsx-conditional-formatting-rule): 批量应用 Excel 条件格式，如阈值标红、数据条与色阶

## 示例

- [XLSX 样本](https://elysiatools.com/zh/samples/xlsx-samples): 用于工作表解析与数据提取测试的 XLSX 样本
- [XLS 样本](https://elysiatools.com/zh/samples/xls-samples): 用于二进制表格解析与导入测试的旧版 Excel (XLS) 表格样本
- [Terraform Plan JSON 样本](https://elysiatools.com/zh/samples/terraform-plan-json-samples): 用于依赖可视化和变更审查的 Terraform plan JSON 文件样本，贴近 terraform show -json 输出结构
- [聊天记录 JSON 示例](https://elysiatools.com/zh/samples/chat-transcript-json): 多角色聊天记录的 JSON 示例

## 相关内容

- [从 JSON 样本与电子表格推导 JSON Schema](https://elysiatools.com/zh/hubs/json-schema-inference-from-samples-and-spreadsheets): 从代表性的 JSON 样本或 XLSX 行数据生成可审阅的 JSON Schema 草案，再检查类型、必填性、空值和异常值，确认后才用于后续契约工作。
- [JSON 到强类型代码生成器](https://elysiatools.com/zh/hubs/json-to-typed-code-generators): 从 JSON 或 schema 证据生成 TypeScript、Go、Rust、Kotlin、Java、C# 与 Zod 校验模型。
- [XLSX 多来源 ETL 导入与数仓交付](https://elysiatools.com/zh/hubs/xlsx-etl-ingestion-workflows): 把多个工作簿和 CSV 来源整理成可追溯、带 schema 依据的 SQL、Parquet 与对象存储批处理输入。