Python实现将列表导出为Excel文件

 更新时间:2025年12月29日 08:32:21   作者:Eiceblue  
在 Python 数据处理场景中,将列表(List)数据导出为 Excel 文件是高频需求,本文将演示如何用 Free Spire.XLS for Python 实现列表转 Excel,感兴趣的小伙伴可以了解下

在 Python 数据处理场景中,将列表(List)数据导出为 Excel 文件是高频需求(如数据报表、批量数据导出等)。相比于传统的openpyxlxlwt等库,Free Spire.XLS for Python 是一款免费的 Excel 处理库,无需依赖 Microsoft Excel,支持完整的 Excel 文件创建、编辑和格式设置,尤其适合新手快速实现列表到 Excel 的转换。

本文将从环境准备、基础示例到进阶优化演示如何用 Free Spire.XLS for Python 实现列表转 Excel,覆盖以下核心场景:

  • 基础实战:导出一维列表到 Excel(单列)
  • 进阶实战:导出二维列表到 Excel(带表头)
  • 实战拓展:导出字典列表到 Excel(贴合业务场景)

1. 安装免费库

Free Spire.XLS for Python 支持 Python 3.6 及以上版本,通过 pip即可安装:

pip install Spire.XLS.Free

2. 基础实战:导出一维列表到 Excel(单列)

实现思路

  • 创建空白工作簿,获取默认工作表;
  • 遍历一维列表,将每个元素写入 Excel 的指定列(如A列);
  • 保存 Excel 文件并释放资源。

Python 代码

from spire.xls import *
from spire.xls.common import *

# 定义要转换的一维列表
one_dimensional_list = ["Python", "Java", "C++", "JavaScript", "Go"]

# 1. 创建工作簿对象
workbook = Workbook()
# 2. 获取第一个工作表(默认创建)
worksheet = workbook.Worksheets[0]
# 3. 设置工作表名称
worksheet.Name = "编程语言列表"

# 4. 遍历列表,写入Excel(从第1行第1列开始)
for index, value in enumerate(one_dimensional_list):
    # 行号从1开始
    row = index + 1
    # 写入A列(第1列)
    worksheet.Range[row, 1].Text = value

# 5. 保存Excel文件(支持.xlsx/.xls/.xlsm等格式)
output_path = "一维列表转Excel.xlsx"
workbook.SaveToFile(output_path, FileFormat.Version2016)

# 6. 释放资源(重要,避免内存泄漏)
workbook.Dispose()

print(f"一维列表已成功导出到:{output_path}")

代码解析

  • Workbook():创建 Excel 工作簿对象,相当于新建一个 Excel 文件;
  • Worksheets[0]:获取工作簿中第一个工作表(索引从0开始);
  • Range[row, col]:定位 Excel 单元格,行/列号均从1开始
  • Text:设置单元格的文本内容;
  • SaveToFile():保存文件,第二个参数指定Excel版本;
  • Dispose():释放工作簿资源,避免占用内存。

效果图:

3. 进阶实战:导出二维列表到 Excel(带表头)

实现思路

  • 定义二维列表(包含表头和数据);
  • 先写入表头行,再遍历数据行逐行写入;
  • 可选:设置表头样式(加粗、居中)提升可读性。

完整代码

from spire.xls import *
from spire.xls.common import *

# 定义二维列表(表头+数据)
two_dimensional_list = [
    ["姓名", "年龄", "城市", "职业"],  # 表头
    ["张三", 28, "北京", "工程师"],
    ["李四", 32, "上海", "产品经理"],
    ["王五", 25, "广州", "设计师"],
    ["赵六", 30, "深圳", "开发工程师"]
]

# 1. 创建工作簿
workbook = Workbook()
worksheet = workbook.Worksheets[0]
worksheet.Name = "人员信息表"

# 2. 遍历二维列表,逐行写入Excel
for row_index, row_data in enumerate(two_dimensional_list):
    # Excel行号从1开始
    current_row = row_index + 1
    for col_index, cell_value in enumerate(row_data):
        # Excel列号从1开始
        current_col = col_index + 1
        # 写入单元格内容
        worksheet.Range[current_row, current_col].Text = str(cell_value)
        
        # 3. 优化表头样式(加粗、居中)
        if current_row == 1:
            worksheet.Range[current_row, current_col].Style.Font.IsBold = True
            worksheet.Range[current_row, current_col].Style.HorizontalAlignment = HorizontalAlignType.Center

# 4. 自动调整列宽(适配内容长度)
worksheet.AllocatedRange.AutoFitColumns()

# 5. 保存文件
output_path = "二维列表转Excel.xlsx"
workbook.SaveToFile(output_path, FileFormat.Version2016)
workbook.Dispose()

print(f"二维列表已成功导出到:{output_path}")

代码解析

  • 二维列表遍历:外层循环控制行,内层循环控制列,实现“逐行逐列”写入;
  • 表头样式优化:通过 IsBold = True 设置加粗, HorizontalAlignType.Center 设置水平居中;
  • AllocatedRange.AutoFitColumns():自动调整列宽,避免内容被截断;
  • 数据类型转换:str(cell_value)确保数字、字符串等类型统一写入,避免类型报错。

效果图:

4. 实战拓展:导出字典列表到 Excel(贴合业务场景)

字典列表是 Python 业务开发中最常用的数据格式(如从数据库/接口获取的结构化数据),每个字典代表一行数据,字典的对应Excel表头,对应单元格数据。以下是完整实现方案。

实现思路

  • 定义字典列表(每个字典的键为字段名,值为字段值);
  • 提取字典的键作为 Excel 表头(需确保字典键一致,或兼容键缺失场景);
  • 先写入表头行并设置样式,再遍历字典列表,按表头顺序提取值写入单元格;
  • 自动调整列宽,提升 Excel 可读性。

完整代码

from spire.xls import *
from spire.xls.common import *

# 定义字典列表(模拟业务场景:从接口/数据库获取的用户数据)
dict_list = [
    {"用户ID": 1001, "姓名": "张三", "年龄": 28, "城市": "北京", "注册时间": "2024-01-15"},
    {"用户ID": 1002, "姓名": "李四", "年龄": 32, "城市": "上海", "注册时间": "2024-02-20"},
    {"用户ID": 1003, "姓名": "王五", "年龄": 25, "城市": "广州", "注册时间": "2024-03-10"},
    {"用户ID": 1004, "姓名": "赵六", "年龄": 30, "城市": "深圳", "注册时间": "2024-04-05"}
]

# 1. 创建工作簿和工作表
workbook = Workbook()
worksheet = workbook.Worksheets[0]
worksheet.Name = "用户信息表(字典列表)"

# 2. 提取表头(字典的键)
if not dict_list:
    print("字典列表为空,无需导出!")
    workbook.Dispose()
    exit()
# 以第一个字典的键作为表头(确保所有字典键一致,或参考下方注意事项处理)
headers = list(dict_list[0].keys())

# 3. 写入表头行并设置样式
for col_index, header in enumerate(headers):
    current_col = col_index + 1
    # 写入表头文本
    worksheet.Range[1, current_col].Text = header

# 4. 遍历字典列表,写入数据行
for row_idx, data_dict in enumerate(dict_list):
    current_row = row_idx + 2  # 表头占第1行,数据从第2行开始
    for col_idx, header in enumerate(headers):
        current_col = col_idx + 1
        # 提取字典值(用get方法兼容键缺失场景,避免KeyError)
        cell_value = data_dict.get(header, "")
        # 写入单元格(统一转字符串,避免类型报错)
        worksheet.Range[current_row, current_col].Text = str(cell_value)

# 5. 自动调整列宽(适配内容长度)
worksheet.AllocatedRange.AutoFitColumns()

# 6. 保存Excel文件
output_path = "字典列表转Excel.xlsx"
workbook.SaveToFile(output_path, FileFormat.Version2016)

# 7. 释放资源
workbook.Dispose()

print(f"字典列表已成功导出到:{output_path}")

代码解析

  • 表头提取list(dict_list[0].keys()) 从第一个字典中提取所有键作为 Excel 表头,是业务场景中最常用的方式;
  • 兼容键缺失data_dict.get(header, "") 替代直接取值data_dict[header],若某个字典缺失指定键,会填充空字符串,避免KeyError报错;
  • 行号计算:数据行从第2行开始(current_row = row_idx + 2),因为第1行已写入表头;

效果图:

5. 常见问题与注意事项

免费版限制:Free Spire.XLS for Python 在读写 .xls 格式的 Excel 文档时,有每个文档 5 个工作表,每个工作表 200 行的限制。读写 .xlsx 格式的 Excel 文档时没有任何限制;

中文乱码问题:若导出的Excel出现中文乱码,需确保代码文件编码为 UTF-8,且写入时直接使用字符串(无需额外转码);

资源释放:务必调用 Dispose() 释放工作簿资源,否则可能导致文件被占用(无法删除/修改);

文件格式FileFormat.Version2016 对应.xlsx格式,FileFormat.Excel97to2003 对应.xls格式(兼容旧版Excel);

字典列表兼容:若字典键不一致,优先提取所有唯一键作为表头,并用get方法取值避免报错。

# 提取所有唯一键作为表头
all_headers = set()
for d in dict_list:
    all_headers.update(d.keys())
headers = sorted(list(all_headers))  # 排序保证表头顺序固定

以上就是Python实现将列表导出为Excel文件的详细内容,更多关于Python列表导出为Excel的资料请关注脚本之家其它相关文章!

相关文章

  • Python结合moviepy和tkinter自制音视频转字幕工具

    Python结合moviepy和tkinter自制音视频转字幕工具

    在多媒体内容爆炸的时代,为音视频添加字幕成为提升内容可访问性、传播效率的重要手段,本文将使用Python自制一个音视频转字幕工具,感兴趣的小伙伴可以了解下
    2025-12-12
  • Python下载懒人图库JavaScript特效

    Python下载懒人图库JavaScript特效

    本文给大家分享的是使用Python 爬虫抓取懒人图库的JS脚本特效模板的代码,使用了第三方库gevent来实现,有需要的小伙伴可以参考下。
    2015-05-05
  • Python+pyqt5实现一个图像变形工具

    Python+pyqt5实现一个图像变形工具

    FacePrank 是一个功能强大的图像变形工具,使用Python和PyQt5开发,下面小编就为大家介绍一下如何编写一个图像变形工具,实现捏脸效果吧
    2025-11-11
  • Python使用QRCode模块生成二维码实例详解

    Python使用QRCode模块生成二维码实例详解

    这篇文章主要介绍了Python使用QRCode模块生成二维码实例详解的相关资料,需要的朋友可以参考下
    2017-06-06
  • 如何利用python之wxpy模块玩转微信

    如何利用python之wxpy模块玩转微信

    这篇文章主要介绍了利用python之wxpy模块玩转微信,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-08-08
  • 基于python实现Pycharm断点调试

    基于python实现Pycharm断点调试

    这篇文章主要介绍了基于python实现Pycharm断点调试,在我们写程序的时候,很容易遇到各种各样的bug,然后编译器提示程序出错的地方。很多时候可以通过提示的信息修改程序,但是有时我们想得到更多的信息,这个时候就需要进行断点调试,下面我们就一起来学习ycharm断点调试
    2022-02-02
  • Python图像运算之图像灰度非线性变换详解

    Python图像运算之图像灰度非线性变换详解

    这篇文章将详细讲解图像灰度非线性变换。图像灰度非线性变换主要包括对数变换、幂次变换、指数变换、分段函数变换,通过非线性关系对图像进行灰度处理,本文主要讲解三种常见类型的灰度非线性变换,感兴趣的可以了解一下
    2022-03-03
  • pandas把dataframe转成Series,改变列中值的类型方法

    pandas把dataframe转成Series,改变列中值的类型方法

    下面小编就为大家分享一篇pandas把dataframe转成Series,改变列中值的类型方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-04-04
  • pytorch损失反向传播后梯度为none的问题

    pytorch损失反向传播后梯度为none的问题

    这篇文章主要介绍了pytorch 出现损失反向传播后梯度为none的问题,具有很好的参考价值,如有错误或未考虑完全的地方,望不吝赐教
    2021-05-05
  • Python使用Pandas处理.xlsx文件的详细教程

    Python使用Pandas处理.xlsx文件的详细教程

    这篇文章主要介绍了如何使用Pandas库处理.xlsx文件,包括环境配置、读取、写入、数据操作和高级操作,Pandas提供了丰富的功能,使得数据处理变得简单高效,需要的朋友可以参考下
    2025-02-02

最新评论