Python导出列表数据到Excel：三种场景实现（基于Spire.XLS）
在日常数据处理中，将 Python 列表结构的数据导出为 Excel 文件是常见需求，例如数据分析结果输出、业务报表生成或接口数据落地。Excel 具有良好的可读性和广泛兼容性，是数据交付的主流格式。本文基于 Free Spire.XLS for Python 库，讲解一维列表、二维列表和字典列表三种典型场景的导出实现，并提供完整代码与关键技术细节。一、环境准备
Free Spire.XLS for Python 是一款独立的 Excel 处理组件，无需 Microsoft Office 环境，支持 .xls 与 .xlsx 格式的创建与编辑。免费版对工作表数量和数据行数有一定限制，适用于中小规模数据导出。
安装方式：
pip install Spire.Xls.Free
安装后引入核心模块：
from spire.xls import *
from spire.xls.common import *
核心对象包括 Workbook（工作簿）、Worksheet（工作表）和 CellRange（单元格区域），构成 Excel 操作的基础层级。
二、场景一：一维列表导出单列数据
一维列表结构简单，在 Excel 中通常表现为单独的一列数据，适合存放产品名称、员工编号等信息。
实现思路：创建 Workbook → 获取 Worksheet → 遍历列表按行索引写入单元格 → 调整列宽 → 保存文件并释放资源。
完整代码：
from spire.xls import *
from spire.xls.common import *
def list_to_single_column(data_list, output_path, sheet_name="数据"):
"""将一维列表导出为Excel单列数据"""
workbook = Workbook()
workbook.Worksheets.Clear()
sheet = workbook.Worksheets.Add(sheet_name)
for index, value in enumerate(data_list):
sheet.Range.Value = str(value)
sheet.AllocatedRange.AutoFitColumns()
workbook.SaveToFile(output_path, ExcelVersion.Version2016)
workbook.Dispose()
if __name__ == "__main__":
products = ["笔记本电脑", "机械键盘", "无线鼠标", "27寸显示器", "外接硬盘"]
list_to_single_column(products, "single_column.xlsx")
要点说明：
· 行号与列号均从 1 开始，与 Excel 原生索引方式一致。
· Value 属性自动将输入转为字符串存储；若需保留数值类型，可使用 NumberValue。
· AutoFitColumns() 根据内容自动调整列宽，避免内容截断。
三、场景二：二维列表导出结构化表格
二维列表（列表嵌套列表）最接近 Excel 表格结构，每个子列表对应一行数据，常配合表头使用。
实现思路：分离表头与数据行 → 双层循环按行列坐标写入 → 对表头区域应用样式 → 批量自适应列宽。
完整代码：
from spire.xls import *
from spire.xls.common import *
def list_2d_to_excel(headers, data_rows, output_path, sheet_name="数据表"):
workbook = Workbook()
workbook.Worksheets.Clear()
sheet = workbook.Worksheets.Add(sheet_name)
# 写入表头（第1行）
for col_idx, header in enumerate(headers):
cell = sheet.Range
cell.Value = header
cell.Style.Font.IsBold = True
cell.Style.Color = Color.get_LightBlue()
cell.Style.HorizontalAlignment = HorizontalAlignType.Center
# 写入数据行（从第2行开始）
for row_idx, row_data in enumerate(data_rows):
for col_idx, value in enumerate(row_data):
cell = sheet.Range
if isinstance(value, (int, float)):
cell.NumberValue = float(value)
else:
cell.Value = str(value)
# 添加边框
data_range = sheet.Range
data_range.BorderAround(LineStyleType.Thin)
data_range.BorderInside(LineStyleType.Thin)
sheet.AllocatedRange.AutoFitColumns()
workbook.SaveToFile(output_path, ExcelVersion.Version2016)
workbook.Dispose()
if __name__ == "__main__":
headers = ["员工ID", "姓名", "部门", "月薪", "在职状态"]
employees = [
,
,
,
]
list_2d_to_excel(headers, employees, "employee_table.xlsx")
技术细节：
· 数据类型区分：数值型使用 NumberValue 写入，可在 Excel 中参与公式计算；字符串使用 Value。
· 区域批量操作：通过 sheet.Range[行1, 列1, 行2, 列2] 获取矩形区域，可一次性设置边框、对齐等。
· 布尔值：直接写入会显示 TRUE/FALSE，若需自定义显示文本，需转换为字符串。
四、场景三：字典列表导出为 Excel
字典列表是业务开发中最常见的数据结构，例如数据库查询结果、API 响应数据等，每条记录以键值对形式存在。
实现思路：从首条数据提取键名作为表头 → 遍历每条记录按键顺序写入对应列 → 支持空值容错处理 → 对数值、布尔等特殊字段做类型区分写入。
完整代码：
from spire.xls import *
from spire.xls.common import *
def dict_list_to_excel(dict_list, output_path, sheet_name="数据", custom_headers=None):
if not dict_list:
raise ValueError("数据列表不能为空")
workbook = Workbook()
workbook.Worksheets.Clear()
sheet = workbook.Worksheets.Add(sheet_name)
# 确定表头
if custom_headers:
headers = custom_headers
keys = list(dict_list.keys())
else:
keys = list(dict_list.keys())
headers = keys
# 写入表头
for col_idx, header in enumerate(headers):
cell = sheet.Range
cell.Value = header
cell.Style.Font.IsBold = True
cell.Style.HorizontalAlignment = HorizontalAlignType.Center
# 写入数据
for row_idx, item in enumerate(dict_list):
for col_idx, key in enumerate(keys):
cell = sheet.Range
value = item.get(key, "")
if value is None:
cell.Value = ""
elif isinstance(value, bool):
cell.BooleanValue = value
elif isinstance(value, (int, float)):
cell.NumberValue = float(value)
else:
cell.Value = str(value)
data_range = sheet.Range
data_range.BorderAround(LineStyleType.Thin)
data_range.BorderInside(LineStyleType.Thin)
sheet.AllocatedRange.AutoFitColumns()
workbook.SaveToFile(output_path, ExcelVersion.Version2016)
workbook.Dispose()
if __name__ == "__main__":
orders = [
{"order_id": "ORD2024001", "product": "笔记本支架", "quantity": 2, "price": 89.9, "status": "已发货"},
{"order_id": "ORD2024002", "product": "USB集线器", "quantity": 5, "price": 45.0, "status": "待出库"},
{"order_id": "ORD2024003", "product": "散热底座", "quantity": 1, "price": 129.0, "status": "已签收"},
]
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" 表示美元货币格式。
Re: Python导出列表数据到Excel：三种场景实现（基于Spire.XLS）
感谢分享，教程写得很详细，三种场景覆盖了日常常用的导出类型。之前用 openpyxl 比较多，Spire.XLS 看起来也挺简洁，尤其表头样式和边框设置那部分很实用。想请教一下，免费版对行数的具体限制是多少？如果数据量超过一万行，是不是需要升级付费版本？Re: Python导出列表数据到Excel：三种场景实现（基于Spire.XLS）
感谢楼主分享，非常实用的教程！三种场景覆盖了日常最常见的列表导出需求，代码结构清晰，注释也很到位。特别是对表头样式和边框的处理，让生成的文件直接可用，省去了手动格式化的时间。目前项目中正好有二维列表带表头的导出场景，打算直接拿来用。想请教一下：如果数据量较大，Spire.XLS免费版的行数限制大概是多少？另外，对于空列表或空单元格，有没有推荐的默认处理方式？Re: Python导出列表数据到Excel：三种场景实现（基于Spire.XLS）
感谢分享，非常清晰实用的教程！三种场景覆盖了日常开发中大部分列表数据导出的需求，代码结构也很规范，尤其是表头样式和边框添加的细节处理值得学习。想请教一下，如果列表数据中包含中文字符或特殊符号，Spire.XLS在保存时是否需要额外设置编码？另外免费版对行数限制的具体数值大概是多少，有没有官方说明？
页:
[1]