Python写入CSV时怎么去掉多余空行

沿途有光

发布时间：2026-10-30 | 7人浏览过

原创

详细讲解在Python中使用csv模块写入CSV文件时消除多余空行的核心方法，深入分析底层换行符机制，并提供规范代码示例与排查清单。

在 Python 3 中使用标准库 csv 写入文件时，如果在文本编辑器或 Excel 中打开发现每行数据之间都夹杂着一行多余的空白行，核心原因在于调用内置函数 open() 时未指定 newline='' 参数。只要在打开文件时加上 newline=''，即可彻底杜绝多余空行的产生。

一行代码速查：
将 open('data.csv', 'w') 规范改写为 open('data.csv', 'w', newline='', encoding='utf-8')。

一、为什么会出现多余空行？

理解这个问题的本质，需要厘清 Python 的文本流转换机制与 csv 模块的换行符策略之间的相互作用。

根据 RFC 4180 规范，CSV 文件的标准换行符为 \r\n（CRLF）。因此，Python 标准库中的 csv.writer 在构建时，默认的 lineterminator 属性正是 \r\n。每当你调用 writer.writerow() 写入一行记录时，csv.writer 都会在末尾自动附带 \r\n。

然而在 Windows 操作系统中，Python 3 的内置 open() 函数在默认的文本模式（'w'）下启用了通用换行符转换机制：底层会将写入流中的所有 \n 自动转换为系统的默认换行符 \r\n。这就导致了叠加效应：

csv.writer 先将整行数据格式化，结尾生成 \r\n；
文件对象 open() 接收到这个字符串，检测到其中的 \n，再次将其转译替换为 \r\n；
最终实际写入磁盘物理文件的字符序列变成了 \r\r\n；
文本编辑器或 Excel 读取文件时，将第一个 \r 视作一个回车换行，将随后的 \r\n 视作第二个回车换行，从而渲染出了中间的多余空行。

而在指定了 newline='' 后，open() 会关闭内部针对换行符的二次翻译，直接将 csv.writer 生成的原始字节无损流向磁盘，从而输出规整标准的 CSV 文件。

Python写入CSV时怎么去掉多余空行 — 图 1：Python 文本流中换行符二次转译机理与 newline='' 的抑制效果

二、标准写入操作步骤与代码示例

编写 CSV 写入脚本时，建议统一遵循固定的四步操作范式。无论是普通列表写入，还是字典写入，都应始终在打开文件时配置好必要的参数。

1. 基础示例：列表结构写入

在日常数据导出中，最常见的是将二维数组或元组集合写入文件。使用上下文管理器 with 能够确保文件正常关闭，同时传入 newline=''：

import csv

# 待写入的表头与测试数据
headers = ["用户ID", "姓名", "注册城市"]
rows = [
    [1001, "张伟", "北京"],
    [1002, "李娜", "上海"],
    [1003, "王强", "深圳"]
]

# 重点注意：指定 newline='' 与 encoding='utf-8'
with open("users.csv", mode="w", newline="", encoding="utf-8") as f:
    writer = csv.writer(f)
    # 写入单行表头
    writer.writerow(headers)
    # 批量写入多行数据
    writer.writerows(rows)

2. 进阶示例：字典格式写入（DictWriter）

当处理来自 API、数据库或配置项的字典映射数据时，使用 csv.DictWriter 更加直观。同样需要对底层 open() 传入 newline=''：

import csv

data = [
    {"product_id": "P01", "name": "机械键盘", "price": 299},
    {"product_id": "P02", "name": "无线鼠标", "price": 129},
    {"product_id": "P03", "name": "显示器支架", "price": 188}
]

fieldnames = ["product_id", "name", "price"]

with open("products.csv", mode="w", newline="", encoding="utf-8") as f:
    writer = csv.DictWriter(f, fieldnames=fieldnames)
    # 写入字段表头
    writer.writeheader()
    # 批量写入字典列表
    writer.writerows(data)

三、跨环境与不同库的行为差异对照

很多开发者在 Linux 或 macOS 开发机上运行脚本时没有察觉异常，但当脚本部署到 Windows 生产环境或者交由 Windows 上的 Excel 打开时，就会突然出现空行。这种跨环境差异来源于各系统默认行终止符的不同设定。

1. 为什么在 macOS 或 Linux 上往往看不到空行？

在 Linux 和 macOS 环境下，系统的默认行分隔符是单一的换行符 \n（LF）。当调用 open(..., 'w') 写入字符串时，文本模式只将 \n 映射为本机的行分隔符。因为本机的行分隔符本来就是 \n，转换前后完全一致，因此保留了 csv.writer 原始的 \r\n，并未产生多余的额外字符。但如果将这份代码直接迁移部署到 Windows 机器上，问题就会立即暴露。因此，即使在 Unix-like 系统上编写代码，也必须严格加上 newline='' 以确保跨平台一致性。

2. 使用 Pandas 库时的对比

如果使用数据分析库 Pandas 进行处理，其内置的 to_csv() 方法在底层已经处理好了换行问题，默认不会产生多余空行：

import pandas as pd

df = pd.DataFrame({
    "城市": ["杭州", "成都", "武汉"],
    "指标": [98.5, 92.1, 89.4]
})

# index=False 避免将行索引输出，默认不会有多余空行
df.to_csv("cities.csv", index=False, encoding="utf-8-sig")

四、验证方法与常见避坑清单

修改完代码后，如何确认生成的文件已经去掉了多余空行？以下几点检验方法与避坑规则能够帮助快速排查：

1. 如何准确验证换行符？

除了直接用 Excel 查看行间距外，更精准的检验方式是检查底层的字节流：

使用 Python 脚本读取二进制内容验证：通过 open('users.csv', 'rb').read() 查看二进制字节。如果是 b'\r\n'，则表示换行完全合规；若出现 b'\r\r\n'，则说明多余空行依然存在。
使用现代化代码编辑器：在 Visual Studio Code 或 Notepad++ 中开启“显示所有字符/换行符”，可以直接在界面上清晰观察到每一行末尾是标准的 CRLF 还是重复的 CR CR LF。

2. 参数位置注意事项

新手在排查此问题时，常常容易把 newline='' 误当作 csv.writer() 的参数传入。需要谨记：控制字符流转换的是 Python 的文件句柄本身，因此 newline='' 必须且只能作为 open() 函数的参数。一旦写成 csv.writer(f, newline='')，程序将抛出 TypeError: 'newline' is an invalid keyword argument for csv.writer() 错误。

3. 总结

解决 Python 写入 CSV 产生多余空行的问题，本质在于阻断 Windows 下底层文本流对 \n 的重复转译。只要养成在 open() 中显式传入 newline='' 以及配套 encoding 的编码习惯，就能确保脚本在跨平台运行及各类办公软件中均获得整洁、规范且无空行的文件输出。