Python魔术方法:上下文管理器(__enter__和__exit__)
参考:https://www.jianshu.com/p/067ab9c5ee73/
本文环境
win10 + python3.6
文件操作
一般文件操作可以通过open的方式获取一个文件对象fp,比如
1 2 3 | # 以只读模式打开一个文件对象赋值给变量fp fp = open (r 'D:\learn-python3\常用内建模块\file.txt' , 'r' ) # print(fp.read()) |
然后我们可以通过fp
对文件进行读操作,操作完成后,我们需要通过调用fp
对象的close
方法显示的关闭资源,以便让python可以正确的释放相关系统资源
1 2 3 | # 关闭文件对象,关闭文件对象后无法使用文件对象的read()方法,会报ValueError: I/O operation on closed file. # 未关闭文件对象可以使用read()方法,即使文件内容已经全部读取出来使用read()方法返回为空白 fp.close() |
如果在close
之前出现了异常,导致代码不能正常走到close
,就会出现资源不能正常释放的情况
1 2 3 4 | fp = open (r 'D:\learn-python3\常用内建模块\file.txt' , 'r' ) # 以下代码出现异常不会执行下面的close() 1 / 0 fp.close() |
一般可以通过try...except...finally
来捕获异常,因为finally里面的代码是一定会走到,故可以把资源释放的动作放到这里
1 2 3 4 5 6 7 8 9 10 11 12 13 14 | # 使用try关闭文件对象 def do_something(): print ( 'do_something' ) def do_exc(): print ( 'do_exc' ) fp = open (r 'D:\learn-python3\常用内建模块\file.txt' , 'r' ) try : do_something() a = 1 / 0 except : do_exc() finally : fp.close() |
不管之前代码是否报错都会执行finally正确关闭文件对象资源。
上下文管理器
上面的代码虽然可以满足我们的要求,但是比较冗长,而且也不符合python提倡的代码简洁性,所以有一个概念就是上下文管理器,类比到代码就是with
语句
1 2 3 | # 使用with with open (r 'D:\learn-python3\常用内建模块\file.txt' , 'r' ) as fp: do_something() |
上面的代码,就可以自动的在执行完do_something()
这段逻辑后正确的进行释放,会自动的调用close
实现自己的上下文管理器
可以通过定义一个类,满足上下文管理器协议的要求定义,就可以用with
语句来调用,类里面需要定义__enter__
和__exit__
两个方法即可
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | # 类实现上下文管理 class MyContext: def __init__( self ): print ( '__init__' ) def func( self ): print ( 'func' ) def __enter__( self ): print ( '__enter__' ) def __exit__( self , exc_type, exc_value,traceback): print ( '__exit__' ) def test(): print ( 'test' ) with MyContext(): test() |
执行输出如下
1 2 3 4 | __init__ __enter__ test __exit__ |
输出很明显,首先初始化输出__init__
然后实现了上下文管理即with下的语句在执行前执行类的__enter__方法
在执行后执行类的__exit__方法 所以在执行test()的前后分别输出了__enter__和__exit__
假如我们在test里面出现 异常,再看看会执行那些方法
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | # 在with语句执行时报错 class MyContext: def __init__( self ): print ( '__init__' ) def func( self ): print ( 'func' ) def __enter__( self ): print ( '__enter__' ) def __exit__( self , exc_type, exc_value,traceback): print ( '__exit__' ) def test(): print ( 'test' ) # 以下语句会出现异常 1 / 0 with MyContext(): test() |
输出
1 2 3 4 5 6 7 8 9 10 | __init__ __enter__ test __exit__ Traceback (most recent call last): File "d:/learn-python3/学习脚本/上下文管理/use_enter_exit.py" , line 67 , in <module> test() File "d:/learn-python3/学习脚本/上下文管理/use_enter_exit.py" , line 65 , in test 1 / 0 ZeroDivisionError: division by zero |
注意:输出是先正常输出,然后再尾部抛出错误,即输出__exit__以后再抛出1/0执行的错误,而不是在输出test一个抛出1/0执行的错误
同样,所有的都执行了,就算test
引发了异常,但是__exit__
仍然会执行
上面都是用的with
语句,现在来看看with...as
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | # 使用with..as class MyContext: def __init__( self ): print ( '__init__' ) def func( self ): print ( 'func' ) def __enter__( self ): print ( '__enter__' ) def __exit__( self , exc_type, exc_value, traceback): print ( '__exit__' ) # 这个with语句不等同于 my = MyContext(),而是等同于my = MyContext().__enter__(),由于__enter__并 # 没有返回任何值,默认就是None,故在调用my.fun()会抛出异常 with MyContext() as my: my.func() |
输出结果
1 2 3 4 5 6 7 | __init__ __enter__ __exit__ Traceback (most recent call last): File "d:/learn-python3/学习脚本/上下文管理/use_enter_exit.py" , line 87 , in <module> my.func() AttributeError: 'NoneType' object has no attribute 'func' |
因为__enter__方法没有定义返回所以返回为None使用调用fun()报错
我们把__enter__
返回self
自己
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 | # 使用with..as __enter__返回自己 即可调用func()函数 class MyContext: def __init__( self ): print ( '__init__' ) def func( self ): print ( 'func' ) def __enter__( self ): print ( '__enter__' ) return self def __exit__( self , exc_type, exc_value, traceback): print ( '__exit__' ) # 这个with语句不等同于 my = MyContext(),而是等同于my = MyContext().__enter__(),由于__enter__并 # 没有返回任何值,默认就是None,故在调用my.fun()会抛出异常 with MyContext() as my: my.func() |
输出如下
正常实现了上下文即在执行的前后执行__enter__()和__exit__
1 2 3 4 | __init__ __enter__ func __exit__ |
执行顺序和异常抛出问题
1,在__enter__返回之前出现异常,那么上下文管理是没有形成的,此时__exit__是不能被执行的,除非显示调用(即self.__exit__()这样调用)
首先看__init__里面引发异常
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | # 在__enter__返回之前出现异常,那么上下文管理是没有形成的,此时__exit__是不能被执行的,除非显示调用(即self.__exit__()这样调用) # __init__引发异常 class MyContext: def __init__( self ): print ( '__init__' ) 1 / 0 def func( self ): print ( 'func' ) def __enter__( self ): print ( '__enter__' ) return self def __exit__( self , exc_type, exc_value, traceback): print ( '__exit__' ) # 这个with语句不等同于 my = MyContext(),而是等同于my = MyContext().__enter__(),由于__enter__并 # 没有返回任何值,默认就是None,故在调用my.fun()会抛出异常 with MyContext() as my: my.func() |
结果只执行到了__init__
,引发异常后,代码终止,连__enter__
都无法执行
输出结果
1 2 3 4 5 6 7 | __init__ Traceback (most recent call last): File "d:/learn-python3/学习脚本/上下文管理/use_enter_exit.py" , line 128 , in <module> with MyContext() as my: File "d:/learn-python3/学习脚本/上下文管理/use_enter_exit.py" , line 115 , in __init__ 1 / 0 ZeroDivisionError: division by zero |
在来看__enter__出现异常
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | # __enter__出现异常 class MyContext: def __init__( self ): print ( '__init__' ) def func( self ): print ( 'func' ) def __enter__( self ): print ( '__enter__' ) 1 / 0 return self def __exit__( self , exc_type, exc_value, traceback): print ( '__exit__' ) # 这个with语句不等同于 my = MyContext(),而是等同于my = MyContext().__enter__(),由于__enter__并 # 没有返回任何值,默认就是None,故在调用my.fun()会抛出异常 with MyContext() as my: my.func() |
输出结果
1 2 3 4 5 6 7 8 | __init__ __enter__ Traceback (most recent call last): File "d:/learn-python3/学习脚本/上下文管理/use_enter_exit.py" , line 149 , in <module> with MyContext() as my: File "d:/learn-python3/学习脚本/上下文管理/use_enter_exit.py" , line 141 , in __enter__ 1 / 0 ZeroDivisionError: division by zero |
虽然执行到了__enter__
,但是仍然没有执行__exit__
,代码就终止了
2,__exit__
的三个参数对应了引发异常后的三个参数,对应的就是sys.exc_info()
返回的对象,如果没有引发异常,它们的值都是None
首先看下出现异常它们的值
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | # __exit__的三个参数对应了引发异常后的三个参数 class MyContext: def __init__( self ): print ( '__init__' ) def func( self ): 1 / 0 print ( 'func' ) def __enter__( self ): print ( '__enter__' ) return self def __exit__( self , exc_type, exc_value, traceback): print ( '__exit__' ) print (exc_type, exc_value, traceback) # 这个with语句不等同于 my = MyContext(),而是等同于my = MyContext().__enter__(),由于__enter__并 # 没有返回任何值,默认就是None,故在调用my.fun()会抛出异常 with MyContext() as my: my.func() |
输出结果
1 2 3 4 5 6 7 8 9 10 11 | __init__ __enter__ __exit__ # 分别是异常类型,异常值和异常跟踪对象 < class 'ZeroDivisionError' > division by zero <traceback object at 0x000001AFB23683C8 > Traceback (most recent call last): File "d:/learn-python3/学习脚本/上下文管理/use_enter_exit.py" , line 172 , in <module> my.func() File "d:/learn-python3/学习脚本/上下文管理/use_enter_exit.py" , line 158 , in func 1 / 0 ZeroDivisionError: division by zero |
再来看看未出现异常的时候
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | class MyContext: def __init__( self ): print ( '__init__' ) def func( self ): #1 / 0 print ( 'func' ) def __enter__( self ): print ( '__enter__' ) return self def __exit__( self , exc_type, exc_value, traceback): print ( '__exit__' ) print (exc_type, exc_value, traceback) # 这个with语句不等同于 my = MyContext(),而是等同于my = MyContext().__enter__(),由于__enter__并 # 没有返回任何值,默认就是None,故在调用my.fun()会抛出异常 with MyContext() as my: my.func() |
输出结果
1 2 3 4 5 | __init__ __enter__ func __exit__ None None None |
3,__exit__
默认是返回的None
,上面的例子可以看出,异常虽然出现了,但是仍然会继续抛出,我们可以通过让__exit__
返回True
来屏蔽异常
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 | # __exit__返回True屏蔽异常 class MyContext: def __init__( self ): print ( '__init__' ) def func( self ): 1 / 0 print ( 'func' ) def __enter__( self ): print ( '__enter__' ) return self def __exit__( self , exc_type, exc_value, traceback): print ( '__exit__' ) print (exc_type, exc_value, traceback) return True # 这个with语句不等同于 my = MyContext(),而是等同于my = MyContext().__enter__(),由于__enter__并 # 没有返回任何值,默认就是None,故在调用my.fun()会抛出异常 with MyContext() as my: my.func() |
输出结果
1 2 3 4 | __init__ __enter__ __exit__ < class 'ZeroDivisionError' > division by zero <traceback object at 0x000001B010D478C8 > |
由于__exit__
返回了True
,异常被屏蔽,代码不会终止,会继续往下执行,但是注意,屏蔽异常,一定要自己在__exit__
里面处理异常,或者你根本不care这个异常
总结
__enter__
需要返回一个对象,才能通过with...as
把一个变量引用到这个对象上__exit__
有4个参数,后面三个分别是exc_type
,exc_value
和traceback
__enter__
必须正确返回后(就算是返回默认的None
),上下文管理器协议才生效__exit__
默认返回None
,出现异常仍然会继续抛出,返回True
则会屏蔽异常
【推荐】国内首个AI IDE,深度理解中文开发场景,立即下载体验Trae
【推荐】编程新体验,更懂你的AI,立即体验豆包MarsCode编程助手
【推荐】抖音旗下AI助手豆包,你的智能百科全书,全免费不限次数
【推荐】轻量又高性能的 SSH 工具 IShell:AI 加持,快人一步
· SQL Server 2025 AI相关能力初探
· Linux系列:如何用 C#调用 C方法造成内存泄露
· AI与.NET技术实操系列(二):开始使用ML.NET
· 记一次.NET内存居高不下排查解决与启示
· 探究高空视频全景AR技术的实现原理
· 阿里最新开源QwQ-32B,效果媲美deepseek-r1满血版,部署成本又又又降低了!
· AI编程工具终极对决:字节Trae VS Cursor,谁才是开发者新宠?
· 开源Multi-agent AI智能体框架aevatar.ai,欢迎大家贡献代码
· Manus重磅发布:全球首款通用AI代理技术深度解析与实战指南
· 被坑几百块钱后,我竟然真的恢复了删除的微信聊天记录!
2017-08-19 单机时代