Python文件操作的四大核心陷阱是路径拼接错误、编码缺失、模式误选和未用with管理资源；应优先使用pathlib.Path处理路径、显式指定encoding、按读写需求选mode、强制with确保关闭。
Python 文件操作本身不复杂，但出错时往往卡在路径、编码、权限或资源未释放这些细节上。真正难的不是 open() 怎么写，而是为什么 FileNotFoundError 明明文件存在却报错，或者 UnicodeDecodeError 在 Windows 上频发。
为什么 os.path.join() 比字符串拼接更安全
直接用 "dir" + "/" + "file.txt" 或 "dir\\file.txt" 会硬编码路径分隔符，导致跨平台失败（比如 macOS/Linux 用 /，Windows 用 \\）。os.path.join() 自动适配当前系统。
常见错误：传入含分隔符的子路径，比如 os.path.join("a", "/b/c") → 结果是 /b/c（前面被丢弃），因为绝对路径优先级更高。
- 始终把各路径段作为独立参数传入：
os.path.join("data", "raw", "input.csv") - 避免混用
"/"和"\\"字面量 - 检查是否意外传入了以
/或C:\\开头的“绝对路径片段”
用 pathlib.Path 替代 os 模块的三个实际好处
pathlib 是 Python 3.4+ 官方推荐的路径操作方式，不是语法糖，而是重构了抽象层级：路径是对象，不是字符串。
立即学习“Python免费学习笔记（深入）”；
典型场景：遍历目录下所有 JSON 文件并读取内容。
from pathlib import Pathjson_files = Path("data").glob("*.json") for p in json_files: content = p.read_text(encoding="utf-8") # 自动打开+读取+关闭 print(p.name, len(content))
-
p.exists()、p.is_file()、p.suffix等方法语义清晰，无需再调os.path.isfile(str(p)) -
p.read_text()/p.write_text()默认处理编码，比open(...).read()少两行且不易漏close() - 支持链式操作：
Path("log").resolve() / "error.log"（/是重载运算符）
open() 的 mode 参数到底怎么选
模式选错是 io.UnsupportedOperation 或乱码的主因。关键看两个维度：操作类型（读/写/追加）、数据类型（文本/二进制）。
最常误用："r+" 想读写文本文件，却没注意它不会自动处理换行符和编码；"w" 覆盖写入时清空原文件——这点容易被忽略。
- 纯读文本：用
"r"（默认），显式指定encoding="utf-8" - 追加日志：用
"a"，不是"w"，否则每次运行都清空 - 读写同一文件且需保留原内容：用
"r+"，但必须手动seek()定位，且不能直接write()覆盖中间部分 - 处理图片/PDF/Excel：必须用
"rb"或"wb"，文本模式会破坏二进制数据
为什么 with open() 不是可选项，而是强制习惯
不用 with 的后果不是“可能出错”，而是“一定会泄漏资源”：文件句柄耗尽后，后续 open() 直接抛 OSError: Too many open files，尤其在循环中反复打开文件时。
常见假安全写法：try...finally 手动 close() —— 看似严谨，但一旦 read() 抛异常，close() 可能不执行（比如 MemoryError）。
-
with open(...)确保无论是否异常，文件都会关闭 - 多个文件可写成
with open(a) as f1, open(b) as f2: - 如果真需要延迟关闭（极少数场景），明确用
f = open(...); ...; f.close()，并清楚承担风险
路径拼错、编码设错、模式选错、忘记 with —— 这四类问题占了日常文件操作报错的 80% 以上。与其记函数列表，不如先盯住这四个动作点：拼路径用 Path、读文本必写 encoding、写模式看清楚是 w 还是 a、所有 open() 必套 with。
