Python TextIOWrapper 换行转换：已经写好 CRLF，为什么文件里又多了一个 CR
导出文本时，程序先把每行结尾拼成CRLF，又把文本流的newline设成CRLF，结果下游看见多余回车。这里通常发生了两次转换：字符串里已经有CR，文本层又把其中的LF替换成CRLF。先分清内存字符串与最终字节，就能找到多出来的字符由谁加入。
本文用LF表示\n，CR表示\r，CRLF表示\r\n。完整程序已在Linux、CPython 3.12.14执行；保存为demo.py，用python3 demo.py运行。BytesIO让实验全部留在内存，且写端显式指定换行规则，不依赖当前操作系统的默认行结束符。
AI模型生成概念图：纸带经过滚轮后可以保持、统一或重复折叠，用于比喻换行转换次数；图片不是实际文本文件截图。
同一份字节先读三遍
raw里同时含CRLF、单独CR和单独LF。每次给新的TextIOWrapper一份独立BytesIO，再用list按行读取，避免前一次读取的位置影响下一轮。写入部分则使用相同编码、不同字符串与newline组合，通过getvalue检查最终字节，而不是依赖终端显示是否像多了一行。
完整可运行程序
from io import BytesIO, TextIOWrapper
raw = b"A\r\nB\rC\n"
expected = {
None: ["A\n", "B\n", "C\n"],
"": ["A\r\n", "B\r", "C\n"],
"\n": ["A\r\n", "B\rC\n"],
}
for mode in (None, "", "\n"):
with TextIOWrapper(BytesIO(raw), encoding="ascii", newline=mode) as text:
lines = list(text)
assert lines == expected[mode]
print("read", repr(mode), ":", repr(lines))
def encoded(text, newline):
buffer = BytesIO()
with TextIOWrapper(buffer, encoding="ascii", newline=newline) as stream:
stream.write(text)
stream.flush()
return buffer.getvalue()
once = encoded("A\nB\n", "\r\n")
twice = encoded("A\r\nB\r\n", "\r\n")
preserved = encoded("A\r\nB\r\n", "")
assert once == b"A\r\nB\r\n"
assert twice == b"A\r\r\nB\r\r\n"
assert preserved == once
print("one translation:", repr(once))
print("pretranslated text:", repr(twice))
print("preserve existing:", repr(preserved))本次实际输出（以下为结果，不是程序）
read None : ['A\n', 'B\n', 'C\n'] read '' : ['A\r\n', 'B\r', 'C\n'] read '\n' : ['A\r\n', 'B\rC\n'] one translation: b'A\r\nB\r\n' pretranslated text: b'A\r\r\nB\r\r\n' preserve existing: b'A\r\nB\r\n'
识别行边界与翻译行结尾是两件事
newline为None时，三种输入结尾都被识别为行边界，并统一返回LF，所以第一组是A、B、C三行，结尾都显示\n。newline为空字符串时，也能认出三种边界，但返回值保留原来的CRLF、CR与LF。空字符串不等于只认LF，也不等于停止按行读取。
newline明确设为LF时，只有LF终止一行。于是A后面的CR保留在第一行，B与C之间的单独CR不再切行，第二项变成B\rC\n。这个反例说明，想保留原始结尾时，应先确定是否仍希望识别所有常见行边界，不能只因“不做翻译”就把newline写成LF。
写端只应有一层负责添加CR
one translation从只含LF的字符串开始，由newline=CRLF完成转换，最终字节是A\r\nB\r\n。pretranslated text本来已经含CRLF，但同一写入规则仍会替换每个LF，于是产生A\r\r\nB\r\r\n。原有CR没有被识别为“已经处理过”而自动跳过。
preserve existing把同一份已含CRLF的文本交给newline空字符串，得到与one translation一致的正确字节。实际选择可以是让文本层统一转换，也可以是上层已经构造精确换行后让文本层原样写入；关键是让负责转换的层次唯一而清楚。
使用repr才能看见被显示隐藏的差别
终端往往把回车当作控制动作，肉眼看到的一行不一定能代表真实字节序列。程序对字符串列表和bytes都用repr，因而CR与LF以转义形式显式出现。排查空行问题时，先保存一个最小输入，再比较repr与十六进制，比不断切换编辑器的换行显示更容易定位。
encoded在读取BytesIO内容之前调用stream.flush，确保写入从文本缓冲传到下面的字节缓冲。它在with内取得bytes副本，再让上下文关闭流，因此没有试图在关闭后的BytesIO上继续getvalue。缓冲刷新和换行翻译是两个独立环节，不能把缺失输出也归因于newline。
格式层的规则应单独验收
示例只处理ASCII字母和控制字符，因此不涉及未知编码探测。真实文本仍应显式选择编码，尤其不能认为newline设置会修复错误解码。若目标格式对嵌入换行还有自己的规则，应先确认格式解析器希望文本层保留什么，再处理字段或记录边界。
这份实验刻意不使用写端默认None，因为它会受到系统默认分隔符影响。跨平台交付需要明确输出约定，并在字节层验收。至少保留混合输入、预先含CRLF的文本和无终止换行的记录作为样本，避免只用一种平台生成的简单文件得到过窄的结论。
参考资料
资料核验日期：2026年10月2日。以上输出来自文中固定输入的本地实跑，程序退出码为0。
