Python文件写入最常踩的坑是编码不一致和模式选错:必须显式指定encoding(推荐'utf-8'),按需选用'w'(覆盖)、'a'(追加)、'x'(独占创建)等模式,注意换行符与with自动关闭。

Python写入文件时,最常踩的坑是编码不一致和文件打开模式选错——轻则乱码,重则覆盖或写入失败。关键就两点:明确指定编码(尤其非英文环境),按需选择模式(w、a、x等语义完全不同)。
必须显式指定 encoding 参数
Python 3 默认用系统编码(Windows 常为 cp936,Linux/macOS 多为 UTF-8),但脚本跨平台运行时极易出错。不加 encoding,中文很可能变问号或报 UnicodeEncodeError。
- 写文本一律用
encoding='utf-8'(推荐通用方案) - 若需兼容旧系统(如 Windows 记事本默认读 ANSI),可选
encoding='gbk',但仅限中文 Windows 环境 - 避免依赖
locale.getpreferredencoding(),它不可靠且随系统变化
写入模式决定数据安全与行为逻辑
模式不是随便选的,每个字母背后都有明确语义:
-
'w':清空原文件再写——误用会丢失全部内容 -
'a':追加到末尾(自动定位到 EOF),适合日志、记录类场景 -
'x':独占创建,文件存在直接报错——防止意外覆盖已有文件 -
'w+'或'a+':同时读写,但要注意指针位置(w+开头在文件首,a+开头在末尾)
换行符要留意平台差异
Python 默认用 \n 换行,但在 Windows 上用记事本打开可能显示为一行。这不是编码问题,而是换行符未转成 \r\n。
立即学习“Python免费学习笔记(深入)”;
- 保持跨平台兼容:写入时用
\n,让 Python 的newline参数自动处理(默认newline=None会将\n转为系统换行符) - 若需强制写入
\r\n(如生成 Windows 配置文件),可设newline=''\code> 并手动写\r\n - 避免混用:不要在字符串里硬写
\r\n又开启newline=None,否则变成\r\r\n
及时关闭或用 with 确保资源释放
忘记 close() 可能导致缓冲区未刷入、文件被锁、内存泄漏。
- 首选
with open(...)语法,退出块自动关闭,异常也不漏 - 不用
with时,务必配对try/finally手动 close - 别依赖解释器退出自动回收——CPython 可能延迟,PyPy 或 Jython 行为更不确定
不复杂但容易忽略。编码和模式选对了,文件操作就稳了一大半。










