如何在 Python（Kivy）中正确读写文件以避免多余换行符

本文详解 kivy 应用中因 `readline()` 自动保留 `n` 导致的文本输入框内容异常换行问题，并提供安全、健壮的文件读写方案。

在 Kivy 应用中持久化用户输入（如配置项）时，常见的陷阱是读写换行符处理不一致：readline() 会将行末的 n 一并读入字符串，而后续直接赋值给 TextInput.text 后，该换行符会被渲染为实际换行；当再次调用 f.write(text + “n”) 保存时，就可能造成“一行变两行”的嵌套换行现象——尤其在初始文件为空或内容含空行时，问题尤为明显。

? 根本原因分析

• ✅ f.readline() 返回的是包含末尾 n 的完整行（如 “valuen”），若未显式去除，TextInput.text = “valuen” 会在 ui 中显示为两行（第二行为空白）；
• ❌ on_stop() 中强制追加 n（如 f.write(text + “n”)）会导致原本已含 n 的字符串被写成 “valuenn”，下一次读取又得到 “valuenn”，形成恶性循环。

✅ 正确做法：统一标准化换行处理

1. 读取时剥离换行符（推荐 rstrip(‘n’)）

def on_start(self):     _ids = self.sm.get_screen("Screeen").ids     try:         with open("settings.txt", "r", encoding="utf-8") as f:             for attr in "abc":                 line = f.readline()                 # 安全去除末尾 n（不误删其他空白符，如需保留空格/制表符）                 _ids[attr].text = line.rstrip('n') if line else ""     except FileNotFoundError:         # 首次运行时 settings.txt 不存在，自动创建空文件         with open("settings.txt", "w", encoding="utf-8") as f:             f.write("nnn")  # 预留三行占位

2. 写入时仅在必要时添加换行符

def on_stop(self):     _ids = self.sm.get_screen("Screeen").ids     with open("settings.txt", "w", encoding="utf-8") as f:         for attr in "abc":             text = _ids[attr].text             # 每行独立写入，末尾统一加 n（避免空行污染）             f.write(text + "n")

⚠️ 关键注意事项

• 始终指定 encoding=”utf-8″：避免跨平台（windows/linux/macOS）换行符（rn vs n）和中文乱码问题；
• 使用 with 语句自动管理文件资源：无需手动调用 f.close()，即使异常也能确保关闭；
• rstrip(‘n’) 比 strip() 更精准：仅移除末尾换行符，保留用户输入的首尾空格（如密码前缀空格、缩进等）；
• 预处理空文件场景：首次运行时捕获 FileNotFoundError 并初始化文件，避免 readline() 报错；
• Kivy TextInput 的 multiline=False 可选加固：若字段仅接受单行，建议在 KV 中设置 multiline: False，从 UI 层杜绝换行输入。

✅ 最终效果

• 输入 “Hello” → 文件存为 “Hellon” → 读取后 text = “Hello” → UI 显示单行；
• 输入 “Test “（末尾带空格）→ 读取后仍为 “Test ” → 空格被保留，符合用户预期。

通过统一“读时去 n、写时加 n”的策略，即可彻底解决 Kivy 中因换行符导致的数据失真问题，确保配置文件可读、可维护、跨平台兼容。