当前位置：首页 > news >正文

通过 pip 直接安装免费版本：

news 2026/7/7 4:59:44

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属性会自动将输入转为字符串存储，若需保留数值类型可使用NumberValue
AutoFitColumns()方法根据内容自动调整列宽，避免内容被截断

场景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")