当前位置：首页 > 文章列表 > 文章 > python教程 > Python 写 CSV 为什么出现多余空行

Python 写 CSV 为什么出现多余空行

来源：17golang原创 2026-09-05 22:01:03 0浏览收藏

用 Python 的 csv.writer 导出文件时，如果 Excel 或文本编辑器看到每条记录之间多出一行，通常不是 writerow() 多写了一条空记录，而是文本文件层和 CSV 层分别处理了一次换行。最稳妥的写法是打开文件时传入 newline=''，再让 csv 模块负责记录结束符。

记住这一条：写 CSV 用 open(path, 'w', newline='', encoding='utf-8')。不要在外层再手动给每行拼换行符。

要点速览

多余空行常见于 newline 默认转换与 CSV 的 \r\n 叠加。
newline='' 让 csv.writer 直接管理 CSV 行结束符，encoding 则固定文本编码。
字段里的换行属于数据内容，只有记录终止符才代表下一条 CSV 记录。

多余空行其实是两层换行处理叠在一起

先看一个容易踩坑的写法：

import csv

rows = [["北京", "研发"], ["杭州", "测试"]]
with open("members.csv", "w", encoding="utf-8") as f:
    writer = csv.writer(f)
    writer.writerows(rows)

csv.writer 的默认方言通常使用 \r\n 作为行结束符。文本文件如果仍按平台默认规则转换换行，某些环境会把这次输出再次改写，于是下游程序可能把一个记录结束理解成两个换行。官方文档特别建议写 CSV 时使用 newline=''，原因正是避免额外的 \r 被加入。

Python csv.writer 中 open 文本层、CSV 行结束符和平台换行转换的静态关系 — 图1：把文本层和 CSV 格式层分开看，才能定位多余空行来自哪一次换行转换。

用 newline='' 固定文件打开边界

改成下面这样，csv 模块接管换行处理：

import csv

rows = [["北京", "研发"], ["杭州", "测试"]]
with open("members.csv", "w", newline="", encoding="utf-8") as f:
    writer = csv.writer(f)
    writer.writerows(rows)

这里的空字符串不是“写入空行”，而是告诉文本 I/O 层不要擅自翻译换行。writerows() 仍然只接收两条记录，输出文件也应该有两条记录。读取 CSV 时同样建议使用 newline=''，否则带引号的字段如果内部含换行，解析也可能出现不符合预期的结果。

如果文件要给不同系统交换，顺手指定 encoding='utf-8'。编码和换行是两个独立问题：前者解决中文和字节解释，后者解决记录边界，不能用改编码来修复空行。

Python 稳定写 CSV 时 newline、encoding、csv.writer、lineterminator 和字段换行的参数关系 — 图2：稳定导出由文件打开参数、writer 方言和字段内容共同决定，字段内换行不能当成空记录。

lineterminator 和字段内换行不要混为一谈

需要统一换行格式时，可以显式设置 lineterminator：

with open("members.csv", "w", newline="", encoding="utf-8") as f:
    writer = csv.writer(f, lineterminator="\n")
    writer.writerow(["姓名", "备注"])
    writer.writerow(["林晓", "第一行\n第二行"])

第一条字符串里的 \n 是字段内容，writer 会按引用规则处理它；每次 writerow() 结束时产生的换行，才是记录边界。若把字段内容里的换行直接替换掉，虽然视觉上不再“空行”，却可能损坏原始备注。

quoting=csv.QUOTE_MINIMAL 一般足够：只有字段包含分隔符、引号或换行等特殊字符时才加引号。不要为了消灭显示问题把 quoting 改成 QUOTE_NONE，那会把格式问题转移成转义错误。

用记录数和原始文本快速定位

排查时先把“看起来多一行”拆成三个问题：文件是否真的多了空记录、字段是否包含换行、还是编辑器把 \r\n 显示成了空白间隔。可以用同一个 writer 写入一份最小数据，再用 reader 统计记录数：

with open("members.csv", newline="", encoding="utf-8") as f:
    records = list(csv.reader(f))
print(len(records))

如果记录数等于写入数量，问题多半在显示方式或换行呈现，而不是 writerow 多写数据。若记录数变多，优先检查是否在循环里手动调用了 f.write("\n")，或把空列表也传给了 writerow()。二进制查看原始内容时，关注 \r\n、\n 的组合，不要只凭肉眼数屏幕上的空白行。