解决Python写入CSV文件出现多空行的问题

问题现象与成因分析

当使用Python标准库中的 csv 模块将数据写入文件时，如果未对文件打开模式进行特殊配置，生成的CSV文件往往包含额外的空行。例如，以下代码尝试将农业产量数据写入 yield.csv：

import csv

csv_headers = ["bid", "单位面积穗数(万)", "千粒重(g)", "每穗粒数", "亩产量(kg)"]

def write_to_csv(headers, r):
    # 注意：此处未指定 newline 参数
    with open("../data/yield.csv", "w", encoding="utf-8") as f:
        writer = csv.writer(f)
        writer.writerow(headers)
        writer.writerows(r)

执行上述代码后，用Excel打开生成的文件，会发现每行数据之间都隔着一行空白。这是因为 csv.writer 在写入数据时，默认会在每行末尾添加换行符（\r\n）。而在Windows系统中，open 函数默认以文本模式打开文件，并会将换行符转换为系统默认的 \r\n。这就导致了双重换行：csv模块输出的 \r\n 加上文本模式转换产生的 \r\n，最终在文件中表现为 \r\n\r\n，即一个空行。

官方推荐解决方案

Python 3 官方文档明确指出，解决此问题的最佳实践是在调用 open() 函数时，显式指定 newline='' 参数。这一参数告诉解释器不要对换行符进行任何自动转换，从而让 csv 模块完全控制输出的换行格式。

具体操作步骤

1. 修改文件打开方式：在 open() 函数中增加 newline=''参数。
2. 保持编码一致：建议明确指定 encoding 参数（如 utf-8 或 GB18030），以避免中文乱码。
3. 执行写入操作：使用 csv.writer 进行常规写入即可。

以下是修正后的代码示例，适用于数据量较大的场景：

# 方案一：Python3官方推荐写法
with open("yield.csv", "w", newline="", encoding="utf-8") as f:
    writer = csv.writer(f)
    writer.writerow(["bid", "单位面积穗数(万)", "千粒重(g)"])
    writer.writerows(data_rows)

另一个实际应用场景示例，涉及特定编码和路径：

with open(r"F:\Desktop\Book3.csv", 'w', encoding='GB18030', newline='') as cwf:
    spamwriter = csv.writer(cwf)
    spamwriter.writerow(['剧名', '主要演员', '上映时间'])
    spamwriter.writerows(kl)

通过添加 newline=''参数，生成的CSV文件将不再包含多余的空行，且能在Excel中正确显示。

小数据量的替代处理方案

如果面对的是已经生成的、包含空行的CSV文件，且数据量较小，不需要重新运行Python脚本，可以采用文本编辑工具进行手动清理。这种方法适用于临时处理少量数据：

1. 使用支持高级编辑功能的文本编辑器（如 Notepad++）打开CSV文件。
2. 全选文件内容（Ctrl + A）。
3. 执行菜单操作：编辑 > 行操作 > 移除空行。

此方法能快速清理格式错误，但不适用于自动化流程或大数据量处理。

总结

Python写入CSV出现多空行是Windows环境下常见的兼容性问题。核心解决思路在于通过 newline=''参数 禁用Python文本模式的自动换行转换，将换行控制完全交给 csv 模块。对于已生成的错误文件，可借助Notepad++等工具进行手动修复。掌握这一细节，能确保数据导出的规范性和兼容性。

以上就是Python解决CSV多空行问题的详细内容，更多关于Python CSV处理技巧的资料请关注本站其它相关文章！