Python / 技术文章

Python 上下文管理器:with 语句到底做了什么

这篇文章解决 Python 开发者只会使用 with、却不了解它内部执行流程的问题,适合已经写过 Python 但没有实现过 enter 和 exit 的开发者。读完后你将能看懂 with 的本质,理解资源管理自动化机制,并实现自己的上下文管理器。

with 语句解决了什么问题

程序中经常需要管理一些需要成对操作的资源,例如文件打开与关闭、数据库连接获取与释放、锁的申请与释放。如果只依赖开发者手动调用清理代码,很容易因为异常、提前返回等情况导致资源没有正确释放。

with 语句的目标不是减少代码数量,而是把资源生命周期管理交给固定协议。进入代码块前执行初始化逻辑,离开代码块时无论是否发生异常,都执行清理逻辑。

例如文件操作中,开发者不需要显式调用关闭方法,Python 会在离开 with 代码块时自动完成关闭动作。

with 背后的上下文管理协议

with 语句依赖上下文管理器协议,核心是两个特殊方法:__enter__ 和 __exit__。

__enter__ 在进入 with 块时调用,通常负责创建资源并返回需要使用的对象。__exit__ 在离开 with 块时调用,负责释放资源,同时可以接收异常信息。

一个简单的上下文管理器执行过程如下:

  1. Python 调用对象的 __enter__ 方法。
  2. 将 __enter__ 的返回值绑定给 as 后面的变量。
  3. 执行 with 内部代码。
  4. 调用对象的 __exit__ 方法处理退出逻辑。

手动实现一个上下文管理器

下面实现一个简单的计时上下文管理器。进入代码块时记录开始时间,退出时计算执行耗时。

python
import time

class Timer:
    def __enter__(self):
        # 保存资源状态,供退出阶段使用
        self.start = time.time()
        return self

    def __exit__(self, exc_type, exc_value, traceback):
        elapsed = time.time() - self.start
        print(f"耗时: {elapsed:.4f} 秒")

with Timer():
    total = sum(range(1000000))
    print(total)

预期输出

text
499999500000
耗时: <TIME> 秒

实际耗时会根据机器性能不同而变化,<TIME> 表示运行时产生的具体数值。

这个例子中,with Timer() 并不是调用了某个特殊关键字能力,而是 Python 自动查找对象上的上下文管理协议,并按照固定流程调用两个方法。

exit 如何处理异常

__exit__ 会接收异常类型、异常对象和追踪信息三个参数。如果代码块内部没有异常,这三个参数都会是 None。

如果发生异常,Python 仍然会调用 __exit__,这也是 with 能保证清理逻辑执行的关键。

__exit__ 的返回值决定异常是否继续传播。返回 True 表示异常已经处理,Python 不会继续抛出;返回其他值或不返回,则异常会继续向外传播。

with 的常见使用场景

上下文管理器适合描述具有明确开始和结束边界的操作。

常见场景包括:

  • 文件资源管理,例如打开文件后自动关闭。
  • 数据库事务管理,例如提交或回滚事务。
  • 线程锁管理,例如进入临界区后自动释放锁。
  • 临时环境修改,例如修改配置后恢复原状态。

标准库中的很多对象都实现了这一协议,例如文件对象和线程锁对象。理解 with 的机制后,遇到这些 API 时就不会把它看成特殊语法,而会理解为一种统一的资源生命周期管理方式。

理解 with 后如何设计自己的上下文管理器

实现上下文管理器时,可以先判断资源是否具有明确的获取和释放阶段。如果有,就可以考虑封装成 with 模式。

设计时重点关注三个问题:

  • 进入阶段需要准备什么资源。
  • 退出阶段必须释放什么状态。
  • 异常发生时是否需要特殊处理。

掌握 __enter__ 和 __exit__ 后,with 语句就不再是 Python 中的语法糖,而是一套可扩展的资源管理协议。

目录与阅读设置

记录一个想法

Python 上下文管理器:with 语句到底做了什么

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通