
本文基于 Free Spire.XLS for Python 免费库从一维列表、二维列表到字典列表三种典型场景逐步讲解列表到 Excel 的转换实现。环境准备Free Spire.XLS for Python 是一款独立的 Excel 处理组件无需依赖 Microsoft Office 环境支持 .xls 与 .xlsx 格式的创建与编辑。免费版对工作表数量和数据行数有一定限制适用于中小规模数据导出场景。安装方式通过 pip 直接安装免费版本pip install Spire.Xls.Free安装完成后在代码中引入核心模块from spire.xls import * from spire.xls.common import *核心对象包括Workbook工作簿、Worksheet工作表和CellRange单元格区域三者构成了 Excel 操作的基础层级。场景1一维列表导出单列数据一维列表是最简单的数据结构通常对应 Excel 中的单列数据例如产品名称列表、员工工号序列等。实现思路创建工作簿并获取工作表遍历列表按行索引依次写入单元格调整列宽以优化显示效果保存文件并释放资源完整代码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) # 遍历列表写入单元格从第1行第1列开始 for index, value in enumerate(data_list): sheet.Range[index 1, 1].Value str(value) # 自动调整列宽 sheet.AllocatedRange.AutoFitColumns() # 保存为xlsx格式 workbook.SaveToFile(output_path, ExcelVersion.Version2016) workbook.Dispose() # 调用示例 if name main: products [笔记本电脑, 机械键盘, 无线鼠标, 27寸显示器, 外接硬盘] list_to_single_column(products, single_column.xlsx)要点说明行号与列号均从 1 开始计数这与 Excel 的原生索引方式一致Value属性会自动将输入转为字符串存储若需保留数值类型可使用NumberValueAutoFitColumns()方法根据内容自动调整列宽避免内容被截断场景2二维列表导出结构化表格二维列表列表嵌套列表是最接近 Excel 表格结构的数据形式每一个子列表对应一行数据通常配合表头使用。实现思路分离表头与数据行分别写入双层循环遍历二维列表按行列坐标写入单元格对表头区域应用基础样式增强可读性批量自适应列宽完整代码from spire.xls import * from spire.xls.common import * def list_2d_to_excel(headers, data_rows, output_path, sheet_name数据表): 将二维列表导出为带表头的Excel表格 workbook Workbook() workbook.Worksheets.Clear() sheet workbook.Worksheets.Add(sheet_name) # 写入表头第1行 for col_idx, header in enumerate(headers): cell sheet.Range[1, col_idx 1] 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[row_idx 2, col_idx 1] if isinstance(value, (int, float)): cell.NumberValue float(value) else: cell.Value str(value) # 添加边框 data_range sheet.Range[1, 1, len(data_rows) 1, len(headers)] 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 [ [1001, 张明, 研发部, 15000, True], [1002, 李华, 产品部, 13500, True], [1003, 王芳, 设计部, 12800, False], [1004, 赵强, 测试部, 11500, True] ] list_2d_to_excel(headers, employees, employee_table.xlsx)技术细节数据类型区分数值型数据使用NumberValue写入可在 Excel 中参与公式计算字符串使用Value属性区域批量操作通过sheet.Range[行1, 列1, 行2, 列2]获取矩形区域可一次性设置边框、对齐方式等样式布尔值处理直接写入时会显示为 TRUE/FALSE若需自定义显示文本需转换为字符串