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。

A Python CLI skill for Cutout.Pro visual APIs — background removal, face cutout, and photo enhancement. Supports file upload & image URL input.

调用 Cutout.Pro 视觉处理 API 进行背景移除、人像抠图和照片增强，支持文件上传与图片 URL 输入。

下载

立即学习“Python免费学习笔记（深入）”；

• 保持跨平台兼容：写入时用 \n，让 Python 的 newline 参数自动处理（默认 newline=None 会将 \n 转为系统换行符）
• 若需强制写入 \r\n（如生成 Windows 配置文件），可设 newline=''\code> 并手动写 <code>\r\n
• 避免混用：不要在字符串里硬写 \r\n 又开启 newline=None，否则变成 \r\r\n

及时关闭或用 with 确保资源释放

忘记 close() 可能导致缓冲区未刷入、文件被锁、内存泄漏。

• 首选 with open(...) 语法，退出块自动关闭，异常也不漏
• 不用 with 时，务必配对 try/finally 手动 close
• 别依赖解释器退出自动回收——CPython 可能延迟，PyPy 或 Jython 行为更不确定

不复杂但容易忽略。编码和模式选对了，文件操作就稳了一大半。