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

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

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

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

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

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 被加入。

用 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'。编码和换行是两个独立问题：前者解决中文和字节解释，后者解决记录边界，不能用改编码来修复空行。

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 的组合，不要只凭肉眼数屏幕上的空白行。

• 打开文件：写入和读取都优先使用 newline=''。
• 固定交换编码：跨环境传输时明确写 encoding。
• 只让 writer 结束记录：不要在 writerow() 外手动追加换行。
• 保留字段内容：字段内换行应由 quoting 保护，不要粗暴替换。

常见问题

把 newline='' 去掉一定会多空行吗？

不一定，每个平台和下游软件的表现可能不同。但 CSV 文档明确建议使用它，因此把它作为稳定写法比依赖环境差异更可靠。

newline='\n' 能不能代替 newline=''？

不要把两者当成同义配置。newline='' 是让 CSV 模块自行处理换行；显式指定其他值会改变文本层的换行转换语义。

为什么加了 newline='' 仍然看到空白行？

继续检查输入数据是否含空列表、字段内换行，以及展示工具是否把记录结束符做了额外视觉留白。先用 csv.reader 统计记录数，再决定是否改数据。

把换行规则留给 csv.writer

这类问题的关键不在于反复替换 \r 或 \n，而是明确每一层的职责：open() 负责以稳定的文本边界打开文件，csv.writer 负责记录、字段引用和行结束符，业务数据保留自己的内容。按这个边界写入，CSV 在 Windows、Linux 和表格软件之间交换时就不必靠猜。