Python导出列表数据到Excel：三种场景实现（基于Spire.XLS）

脚本专家

在日常数据处理中，将 Python 列表结构的数据导出为 Excel 文件是常见需求，例如数据分析结果输出、业务报表生成或接口数据落地。Excel 具有良好的可读性和广泛兼容性，是数据交付的主流格式。本文基于 Free Spire.XLS for Python 库，讲解一维列表、二维列表和字典列表三种典型场景的导出实现，并提供完整代码与关键技术细节。

一、环境准备

Free Spire.XLS for Python 是一款独立的 Excel 处理组件，无需 Microsoft Office 环境，支持 .xls 与 .xlsx 格式的创建与编辑。免费版对工作表数量和数据行数有一定限制，适用于中小规模数据导出。

安装方式：

2. pip install Spire.Xls.Free

复制代码

安装后引入核心模块：

2. from spire.xls import *
3. from spire.xls.common import *

复制代码

核心对象包括 Workbook（工作簿）、Worksheet（工作表）和 CellRange（单元格区域），构成 Excel 操作的基础层级。

二、场景一：一维列表导出单列数据

一维列表结构简单，在 Excel 中通常表现为单独的一列数据，适合存放产品名称、员工编号等信息。

实现思路：创建 Workbook → 获取 Worksheet → 遍历列表按行索引写入单元格 → 调整列宽 → 保存文件并释放资源。

完整代码：

2. from spire.xls import *
3. from spire.xls.common import *
5. def list_to_single_column(data_list, output_path, sheet_name="数据"):
6.     """将一维列表导出为Excel单列数据"""
7.     workbook = Workbook()
8.     workbook.Worksheets.Clear()
9.     sheet = workbook.Worksheets.Add(sheet_name)
11.     for index, value in enumerate(data_list):
12.         sheet.Range[index + 1, 1].Value = str(value)
14.     sheet.AllocatedRange.AutoFitColumns()
15.     workbook.SaveToFile(output_path, ExcelVersion.Version2016)
16.     workbook.Dispose()
18. if __name__ == "__main__":
19.     products = ["笔记本电脑", "机械键盘", "无线鼠标", "27寸显示器", "外接硬盘"]
20.     list_to_single_column(products, "single_column.xlsx")

复制代码

要点说明：
· 行号与列号均从 1 开始，与 Excel 原生索引方式一致。
· Value 属性自动将输入转为字符串存储；若需保留数值类型，可使用 NumberValue。
· AutoFitColumns() 根据内容自动调整列宽，避免内容截断。

三、场景二：二维列表导出结构化表格

二维列表（列表嵌套列表）最接近 Excel 表格结构，每个子列表对应一行数据，常配合表头使用。

实现思路：分离表头与数据行 → 双层循环按行列坐标写入 → 对表头区域应用样式 → 批量自适应列宽。

完整代码：

2. from spire.xls import *
3. from spire.xls.common import *
5. def list_2d_to_excel(headers, data_rows, output_path, sheet_name="数据表"):
6.     workbook = Workbook()
7.     workbook.Worksheets.Clear()
8.     sheet = workbook.Worksheets.Add(sheet_name)
10.     # 写入表头（第1行）
11.     for col_idx, header in enumerate(headers):
12.         cell = sheet.Range[1, col_idx + 1]
13.         cell.Value = header
14.         cell.Style.Font.IsBold = True
15.         cell.Style.Color = Color.get_LightBlue()
16.         cell.Style.HorizontalAlignment = HorizontalAlignType.Center
18.     # 写入数据行（从第2行开始）
19.     for row_idx, row_data in enumerate(data_rows):
20.         for col_idx, value in enumerate(row_data):
21.             cell = sheet.Range[row_idx + 2, col_idx + 1]
22.             if isinstance(value, (int, float)):
23.                 cell.NumberValue = float(value)
24.             else:
25.                 cell.Value = str(value)
27.     # 添加边框
28.     data_range = sheet.Range[1, 1, len(data_rows) + 1, len(headers)]
29.     data_range.BorderAround(LineStyleType.Thin)
30.     data_range.BorderInside(LineStyleType.Thin)
32.     sheet.AllocatedRange.AutoFitColumns()
33.     workbook.SaveToFile(output_path, ExcelVersion.Version2016)
34.     workbook.Dispose()
36. if __name__ == "__main__":
37.     headers = ["员工ID", "姓名", "部门", "月薪", "在职状态"]
38.     employees = [
39.         [1001, "张明", "研发部", 15000, True],
40.         [1002, "李华", "产品部", 13500, True],
41.         [1003, "王芳", "设计部", 12800, False],
42.         [1004, "赵强", "测试部", 11500, True]
43.     ]
44.     list_2d_to_excel(headers, employees, "employee_table.xlsx")

复制代码

技术细节：
· 数据类型区分：数值型使用 NumberValue 写入，可在 Excel 中参与公式计算；字符串使用 Value。
· 区域批量操作：通过 sheet.Range[行1, 列1, 行2, 列2] 获取矩形区域，可一次性设置边框、对齐等。
· 布尔值：直接写入会显示 TRUE/FALSE，若需自定义显示文本，需转换为字符串。

四、场景三：字典列表导出为 Excel

字典列表是业务开发中最常见的数据结构，例如数据库查询结果、API 响应数据等，每条记录以键值对形式存在。

实现思路：从首条数据提取键名作为表头 → 遍历每条记录按键顺序写入对应列 → 支持空值容错处理 → 对数值、布尔等特殊字段做类型区分写入。

完整代码：

2. from spire.xls import *
3. from spire.xls.common import *
5. def dict_list_to_excel(dict_list, output_path, sheet_name="数据", custom_headers=None):
6.     if not dict_list:
7.         raise ValueError("数据列表不能为空")
9.     workbook = Workbook()
10.     workbook.Worksheets.Clear()
11.     sheet = workbook.Worksheets.Add(sheet_name)
13.     # 确定表头
14.     if custom_headers:
15.         headers = custom_headers
16.         keys = list(dict_list[0].keys())
17.     else:
18.         keys = list(dict_list[0].keys())
19.         headers = keys
21.     # 写入表头
22.     for col_idx, header in enumerate(headers):
23.         cell = sheet.Range[1, col_idx + 1]
24.         cell.Value = header
25.         cell.Style.Font.IsBold = True
26.         cell.Style.HorizontalAlignment = HorizontalAlignType.Center
28.     # 写入数据
29.     for row_idx, item in enumerate(dict_list):
30.         for col_idx, key in enumerate(keys):
31.             cell = sheet.Range[row_idx + 2, col_idx + 1]
32.             value = item.get(key, "")
33.             if value is None:
34.                 cell.Value = ""
35.             elif isinstance(value, bool):
36.                 cell.BooleanValue = value
37.             elif isinstance(value, (int, float)):
38.                 cell.NumberValue = float(value)
39.             else:
40.                 cell.Value = str(value)
42.     data_range = sheet.Range[1, 1, len(dict_list) + 1, len(headers)]
43.     data_range.BorderAround(LineStyleType.Thin)
44.     data_range.BorderInside(LineStyleType.Thin)
45.     sheet.AllocatedRange.AutoFitColumns()
46.     workbook.SaveToFile(output_path, ExcelVersion.Version2016)
47.     workbook.Dispose()
49. if __name__ == "__main__":
50.     orders = [
51.         {"order_id": "ORD2024001", "product": "笔记本支架", "quantity": 2, "price": 89.9, "status": "已发货"},
52.         {"order_id": "ORD2024002", "product": "USB集线器", "quantity": 5, "price": 45.0, "status": "待出库"},
53.         {"order_id": "ORD2024003", "product": "散热底座", "quantity": 1, "price": 129.0, "status": "已签收"},
54.     ]
55.     dict_list_to_excel(orders, "orders.xlsx", sheet_name="订单数据")

复制代码

设计考量：
· 类型分发逻辑：通过 isinstance 判断数据类型，分别调用 BooleanValue、NumberValue 等属性，保证数据在 Excel 中以正确类型存储。
· 空值处理：字典中不存在的键或值为 None 时，写入空字符串，避免报错。
· 字符串兜底：未匹配到的类型统一转为字符串写入，确保导出不中断。

五、常见问题与总结

核心思路：将 Python 列表结构映射到 Excel 表格层级。一维列表对应单列，二维列表对应行列矩阵，字典列表对应键值结构记录。实际开发中可根据数据规模和格式要求选择合适的写入方式：简单场景直接遍历，复杂场景封装为通用函数并补充类型判断与异常处理，提升代码复用性与健壮性。

常见问题：
Q：免费版有什么使用限制？
A：免费版对工作簿的工作表数量和数据行数有上限，适合常规开发和中小项目。大规模生产场景可评估商业版本。

Q：能否追加写入已有 Excel 文件？
A：可以。使用 workbook.LoadFromFile(file_path) 加载现有文件，定位目标工作表后继续写入，最后保存覆盖即可。

Q：如何设置数字格式如百分比、货币？
A：通过 sheet.Range[].NumberFormat 属性设置，例如 "0.00%" 表示百分比，"$#,##0.00" 表示美元货币格式。

热心网友2

感谢分享，教程写得很详细，三种场景覆盖了日常常用的导出类型。之前用 openpyxl 比较多，Spire.XLS 看起来也挺简洁，尤其表头样式和边框设置那部分很实用。想请教一下，免费版对行数的具体限制是多少？如果数据量超过一万行，是不是需要升级付费版本？

热心网友2

感谢楼主分享，非常实用的教程！三种场景覆盖了日常最常见的列表导出需求，代码结构清晰，注释也很到位。特别是对表头样式和边框的处理，让生成的文件直接可用，省去了手动格式化的时间。目前项目中正好有二维列表带表头的导出场景，打算直接拿来用。想请教一下：如果数据量较大，Spire.XLS免费版的行数限制大概是多少？另外，对于空列表或空单元格，有没有推荐的默认处理方式？

热心网友2

感谢分享，非常清晰实用的教程！三种场景覆盖了日常开发中大部分列表数据导出的需求，代码结构也很规范，尤其是表头样式和边框添加的细节处理值得学习。想请教一下，如果列表数据中包含中文字符或特殊符号，Spire.XLS在保存时是否需要额外设置编码？另外免费版对行数限制的具体数值大概是多少，有没有官方说明？