如何利用Python的contextlib自定义支持with语句的上下文管理器?

梦伟酱_9213

梦伟酱_9213

2026-08-07

418人浏览

原创

直接写 enter 和 exit 容易出错,因 exit 返回值影响异常传播(true 吞异常),且 enter 失败后 exit 仍执行可能导致空指针访问;推荐优先用 @contextmanager 或 exitstack。

如何利用python的contextlib自定义支持with语句的上下文管理器?

为什么直接写 __enter__ 和 __exit__ 很容易出错?

手写类实现上下文管理器时,__exit__ 的返回值逻辑最容易被忽略:如果它返回 True,异常会被吞掉;返回 None 或 False 才会继续抛出。但很多人只关注资源获取和释放,忘了处理异常传播,导致调试时发现错误“消失”了。

另一个常见问题是资源未正确清理——比如在 __enter__ 中出错后,__exit__ 仍被调用,但此时资源可能根本没初始化成功,直接操作就会触发 AttributeError。

所以除非你明确需要细粒度控制异常行为或复用状态,否则优先用 contextlib.contextmanager 装饰器,它自动帮你隔离异常、避免空指针访问。

用 @contextmanager 写一个带参数的临时目录管理器

contextlib.contextmanager 把函数变成上下文管理器,关键在于用 yield 分隔进入和退出逻辑。yield 前是 __enter__,之后是 __exit__(无论是否异常都会执行)。

from contextlib import contextmanager
import tempfile
import shutil
<p>@contextmanager
def temp_dir(suffix="", prefix="tmp"):
path = tempfile.mkdtemp(suffix=suffix, prefix=prefix)
try:
yield path
finally:
shutil.rmtree(path, ignore_errors=True)
</p>

使用时:

with temp_dir(suffix=".data") as d:
  # 在 d 目录里写文件
  open(f"{d}/test.txt", "w").write("ok")

注意:try/finally 是必须的——不能只用 yield 后直接写 shutil.rmtree,否则 __enter__ 抛异常时 rmtree 会收到未创建的路径。

Secure Python Code Sandbox
Secure Python Code Sandbox

安全 Python 代码沙箱:在隔离的沙箱中执行任意 Python 代码,预装 requests、NumPy、pandas 库。返回 stdout、stderr。

下载

contextlib.ExitStack 适合哪些场景?

当你需要动态管理多个上下文(数量不确定、类型不统一),或者想在运行时决定是否进入某个上下文,ExitStack 比嵌套 with 更灵活。

常见用途:

  • 打开一组文件,但其中某些可能不存在,跳过报错的
  • 为测试临时 patch 多个模块对象,且需保证全部还原
  • 在函数中根据条件决定是否启用日志捕获或 mock

示例:安全地打开多个可选配置文件

from contextlib import ExitStack
<p>config_paths = ["/etc/app.conf", "/usr/local/app.conf", "./local.conf"]
configs = []
with ExitStack() as stack:
for path in config_paths:
try:
f = stack.enter_context(open(path))
configs.append(f.read())
except FileNotFoundError:
continue  # 忽略缺失文件,不中断整个栈
</p>

这里 stack.enter_context() 会自动注册 close() 或 __exit__,即使中间某次 open() 失败,前面已打开的文件仍会被关闭。

自定义类 + contextlib.closing 的坑在哪?

contextlib.closing 只调用对象的 close() 方法,它不检查该方法是否存在或是否幂等。如果你传入一个没有 close() 的对象,会立刻报 AttributeError;如果 close() 不是幂等的(比如第二次调用会报错),在异常路径下可能重复触发。

更隐蔽的问题是:它无法替代真正需要 __enter__ 初始化逻辑的场景。例如数据库连接通常要先 connect() 再 close(),而 closing 只负责收尾。

所以除非你确认对象满足:
- 有 close() 且幂等
- 不需要 __enter__ 阶段的额外准备
否则别图省事硬套 closing,老实用 @contextmanager 或写完整类。

真正难的不是语法,是判断哪里该用装饰器、哪里该用 ExitStack、哪里必须自己写类——边界常出现在异常传播策略和资源依赖关系上。

Python免费学习笔记(深入):立即使用
在学习笔记中,你将探索 Python 的核心概念和高级技巧!

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

2023.07.20

1791

4

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

2023.07.25

4724

7

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.07.31

1749

3

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

2023.08.03

28097

23

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3387

5

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.04

3387

5

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

1203

5

python合并两个列表
python合并两个列表

Python是一种强大的编程语言,具有许多方便的功能和工具。在Python中,有多种方法可以合并两个列表。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

2023.08.10

616

4

python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.11

2623

5

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Uvicorn官方安装与入门手册
Uvicorn官方安装与入门手册

共0课时 | 0人学习

Python uv官方项目管理指南
Python uv官方项目管理指南

共0课时 | 0人学习

Python uv官方安装与入门文档
Python uv官方安装与入门文档

共0课时 | 0人学习