
## 一、背景

在数据处理和系统集成场景中，Excel 与 JSON 是两种极为常见的数据格式。Excel 凭借其直观的表格呈现和广泛的兼容性，长期占据业务数据收集、审核与共享的主导地位；而 JSON 凭借其轻量、结构灵活的特点，在 Web 应用、REST API 和系统间数据交换中更为常用。因此，将 Excel 数据导出为 JSON，是从人工维护的表格数据过渡到机器可读格式的常见需求。

本文将介绍如何使用 Free Spire.XLS for Python 这一免费库，实现 Excel 到 JSON 的导出。该库无需安装 Microsoft Excel 即可读写 .xls、.xlsx 等格式的 Excel文件，适用于服务器环境和自动化任务。

---

## 二、环境准备

### 2.1 安装

免费 Python 库可通过 pip 直接安装：

```bash
pip install spire.xls.free
```

该库支持Python 3.6及以上版本，兼容Windows、Linux和macOS。

### 2.2 导入方式

在代码中引入所需模块：

```python
from spire.xls import Workbook, FileFormat
import json
```

---

## 三、Excel 转 JSON 的几种实现方式

### 3.1 方式一：将整个工作簿直接转换为JSON

从 Spire.XLS for Python 16.7.1 版本开始，该库原生支持将 Excel 工作簿直接保存为 JSON 格式。这是最简洁的方式：

```python
from spire.xls import Workbook, FileFormat
import os

input_file = "销售数据.xlsx"
output_file = "output/工作簿.json"
os.makedirs("output", exist_ok=True)

workbook = Workbook()
workbook.LoadFromFile(input_file)
workbook.SaveToFile(output_file, FileFormat.Json)
workbook.Dispose()
```

执行后，生成的 JSON 中每个工作表名称会作为顶层键，工作表第一行的标题会转换为JSON属性名，后续每一行数据则转换为一个JSON对象。例如，一个包含“销售数据”工作表的Excel文件，生成的JSON结构大致如下：

```json
{
  "销售数据": [
    {
      "订单编号": "SO-1001",
      "客户名称": "北方科技有限公司",
      "产品名称": "笔记本电脑支架",
      "数量": 3,
      "单价": 349,
      "订单状态": "已完成"
    }
  ]
}
```

如果工作簿包含多个工作表，每个工作表都会在同一个 JSON 文件中对应一个独立的顶层键。

### 3.2 方式二：将指定工作表导出为 JSON （免费版适用）

如果只需导出某个特定的工作表，可以先获取该工作表，然后手动构造JSON数据：

```python
from spire.xls import Workbook
import json

workbook = Workbook()
workbook.LoadFromFile("销售数据.xlsx")

# 获取第一个工作表
sheet = workbook.Worksheets[0]

# 获取最大行列
rows = sheet.LastRow
cols = sheet.LastColumn

# 提取表头（第一行）
headers = [sheet.Range[1, i + 1].Text for i in range(cols)]

# 逐行构造JSON数据
data = []
for r in range(2, rows + 1):
    row_dict = {}
    for c in range(1, cols + 1):
        row_dict[headers[c - 1]] = sheet.Range[r, c].Text
    data.append(row_dict)

# 写入JSON文件
with open("指定工作表.json", "w", encoding="utf-8") as f:
    json.dump(data, f, ensure_ascii=False, indent=2)

workbook.Dispose()
```

### 3.3 方式三：将指定单元格区域导出为 JSON （免费版适用）

当只需要导出 Excel 中某个特定区域的数据时，可以通过 `Worksheet.Range[]` 获取目标区域：

```python
from spire.xls import Workbook
import json

workbook = Workbook()
workbook.LoadFromFile("销售数据.xlsx")
sheet = workbook.Worksheets[0]

# 获取指定单元格区域（例如A1到D10）
target_range = sheet.Range["A1:D10"]

# 获取区域的行列数
rows = target_range.LastRow - target_range.FirstRow + 1
cols = target_range.LastColumn - target_range.FirstColumn + 1

# 提取表头
headers = [target_range[1, i + 1].Text for i in range(cols)]

# 提取数据
data = []
for r in range(2, rows + 1):
    row_dict = {}
    for c in range(1, cols + 1):
        row_dict[headers[c - 1]] = target_range[r, c].Text
    data.append(row_dict)

with open("指定区域.json", "w", encoding="utf-8") as f:
    json.dump(data, f, ensure_ascii=False, indent=2)

workbook.Dispose()
```

---

## 四、注意事项

### 4.1 免费版的限制

Free Spire.XLS for Python 作为免费版本，存在以下限制：

- 读写 **.xls**（Excel 97-2003）格式时，每个工作簿最多5个工作表，每个工作表最多200行数据。
- 读写 **.xlsx** 格式时**没有上述限制**。
- 将Excel转换为其他格式时，仅支持前3页。


### 4.2 编码问题

导出的 JSON 件中若包含中文，需要在写入文件时指定 `encoding="utf-8"`，并在 `json.dump()` 中设置 `ensure_ascii=False`，以避免中文被转义为 Unicode 编码。

### 4.3 资源释放

操作完成后建议调用 `Dispose()` 方法释放资源，尤其是在批量处理多个文件时。

---

## 五、总结

以上示例提供了一种无需依赖 Microsoft Excel 即可将 Excel 数据导出为 JSON 的解决方案。对于中小规模的数据处理需求，尤其是需要在无图形界面的服务器环境中运行的场景，它是一个值得考虑的选择。用户可以根据实际需求，选择直接转换整个工作簿、导出指定工作表或区域等不同方式。

在数据处理和系统集成场景中，Excel 与 JSON 是两种极为常见的数据格式。Excel 凭借其直观的表格呈现和广泛的兼容性，长期占据业务数据收集、审核与共享的主导地位；而 JSON 凭借其轻量、结构灵活的特点，在 Web 应用、REST API 和系统间数据交换中更为常用。因此，将 Excel 数据导出为 JSON，是从人工维护的表格数据过渡到机器可读格式的常见需求。

Python 将 Excel 导出为 JSON 的实用指南

编程语言

开发工具

后端

本文介绍如何使用FreeSpire.XLS for Python免费库实现Excel转JSON，提供三种方式：整簿直接转换、指定工作表导出和指定区域导出，并涵盖安装方法、免费版限制及中文编码处理，适合服务器环境自动化数据处理需求。

数据处理

代码解释

服务器

Windows

Python

Linux

JSON

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Python 将 Excel 导出为 JSON 的实用指南-腾讯云开发者社区-腾讯云

Python 将 Excel 导出为 JSON 的实用指南

Python 将 Excel 导出为 JSON 的实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐