__enter__ 单独实现无效,必须与 __exit__ 成对出现;__enter__ 返回值决定 as 绑定对象,__exit__ 必须接收四个参数并正确处理异常与清理。

为什么 __enter__ 单独实现没用?
直接写一个只有 __enter__ 方法的类,Python 不会把它当作上下文管理器——必须同时提供 __exit__,否则 with 语句会报 AttributeError: __exit__。这是最常被忽略的前提,很多人只补了 __enter__ 就以为完事了。
真正起作用的是「一对方法」:__enter__ 负责入场(比如打开资源、获取锁),__exit__ 负责收尾(释放、清理、异常处理)。缺一不可。
__enter__ 的返回值决定 as 绑定什么
这个方法的返回值,就是 with xxx as yyy: 中 yyy 所绑定的对象。不显式 return 就默认返回 None,那 as 后面拿到的就是 None,容易引发 AttributeError。
- 想让
as拿到实例本身?return self - 想返回某个内部资源(比如文件句柄)?
return self._file - 想返回计算结果或临时对象?也可以,但得确保类型和后续使用匹配
__exit__ 的三个参数不能少,顺序不能错
__exit__(self, exc_type, exc_value, traceback) 这四个参数必须齐全,哪怕你只打算做简单清理。Python 在异常发生时会把这三个异常信息传进来;正常退出时三者都是 None。
常见错误是漏掉参数、重命名、或用 *args 模糊处理——这会导致异常无法被正确捕获或压制。
- 想吞掉特定异常(比如忽略
FileNotFoundError)?检查exc_type is FileNotFoundError并返回True - 想让异常继续冒泡?不用 return,或明确
return False - 不管有没有异常都要执行的清理逻辑(如关闭 socket),写在
__exit__函数体开头或结尾,别依赖try/finally套壳
别忘了 __enter__ 抛异常时 __exit__ 不会被调用
如果 __enter__ 里出错了(比如初始化失败),__exit__ 根本不会执行。这时候资源没成功获取,自然也不该清理——但你要确保 __enter__ 自身是安全的,或者在它之前就做好前置校验。
典型陷阱:在 __enter__ 里打开文件并赋值给 self._fp,但没加 try/except,一旦打开失败,实例可能处于半初始化状态,后续再调用其他方法容易出错。
更稳妥的做法是:把资源获取逻辑放在 __enter__,但确保失败时不做任何副作用;或者提前在 __init__ 做轻量准备,把重操作留到 __enter__。
Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!











