with 语句和上下文管理器(Context Manager)的原理

with语句通过上下文管理器协议确保资源在进入和退出代码块时被正确初始化和清理,即使发生异常也能自动释放资源,从而避免资源泄漏;它通过__enter__和__exit__方法或contextlib的@contextmanager装饰器实现,使文件、数据库连接等资源管理更安全、简洁。

with 语句和上下文管理器(context manager)的原理

with

语句在 Python 里,说白了,就是一种优雅地处理资源(比如文件、网络连接、锁)的方式,它能确保这些资源在使用完毕后,不管过程中有没有出错,都能被妥善地清理掉。它的魔法源自“上下文管理器”协议,这个协议定义了对象如何进入和退出一个特定的代码块。

在编程实践中,我们经常需要处理一些有“生命周期”的资源:打开文件后要关闭,连接数据库后要断开,获取锁后要释放。如果手动去管理这些步骤,尤其是在代码路径复杂或者出现异常的情况下,很容易遗漏清理操作,导致资源泄漏或者程序行为异常。

with

语句就是为了解决这个痛点而生的。它通过与实现了特定方法的对象(也就是上下文管理器)协作,在进入

with

代码块时执行资源准备工作,在退出代码块时(无论正常退出还是异常退出)执行资源清理工作。这不仅让代码更简洁,也大大提高了程序的健壮性。

为什么我们要用

with

语句来处理文件或数据库连接?

我记得刚开始写Python的时候,处理文件都是这样:

f = open('my_file.txt', 'r'); data = f.read(); f.close()

。后来发现,如果

f.read()

出了问题,比如文件太大内存溢出,那

f.close()

就根本执行不到,文件句柄就一直开着,时间长了,系统资源就耗尽了。或者说,如果一个函数里有多个

return

语句,你还得在每个

return

之前都加上

f.close()

,想想都头大。

这就是

with

语句的价值所在。它最核心的优势在于“异常安全”和“自动化清理”。

拿文件操作来说,当你写

with open('my_file.txt', 'r') as f:

,Python 会在文件打开后,把文件对象赋值给

f

。当

with

块内的代码执行完毕,或者在执行过程中抛出了任何异常,Python 都会自动调用文件对象的清理方法(也就是关闭文件)。你完全不用操心

f.close()

,也不用写

try...finally

这样的结构。这不仅仅是代码量减少那么简单,更重要的是,它极大地降低了因疏忽而导致资源泄漏的风险。

数据库连接也是一个典型的例子。连接池中的连接是宝贵的资源,一个应用如果不断地获取连接而不释放,很快就会把连接池耗尽,导致其他请求无法获取连接。使用

with

语句来管理数据库连接,可以确保连接在事务完成后(或发生错误时)被自动归还给连接池,或者直接关闭,避免了资源浪费。这种模式让开发者可以更专注于业务逻辑,而不是繁琐的资源管理细节。

自己动手实现一个上下文管理器需要注意什么?

实现一个自定义的上下文管理器,其实就是让你的类遵循上下文管理器协议,也就是实现两个特殊方法:

__enter__

__exit__

__enter__(self)

方法会在

with

语句块被执行前调用。它的主要职责是进行资源的初始化和准备工作,并且它必须返回一个对象。这个对象就是

as

关键字后面跟着的变量所绑定的值。比如,

with MyResource() as res:

res

就会是

MyResource

实例的

__enter__

方法的返回值。如果你的资源对象本身就是你想要操作的对象,那么通常

__enter__

直接返回

self

就可以了。

__exit__(self, exc_type, exc_val, exc_tb)

方法则是在

with

语句块执行完毕后(无论是正常结束还是因为异常而中断)调用。这个方法负责资源的清理工作。它的三个参数非常关键:

exc_type

: 如果

with

块内发生了异常,这里就是异常的类型(比如

ValueError

)。如果没有异常,则是

None

exc_val

: 如果有异常,这里是异常实例本身。没有异常时是

None

exc_tb

: 如果有异常,这里是异常的追踪信息(traceback)。没有异常时是

None

__exit__

方法里,你可以根据

exc_type

是否为

None

来判断

with

块内是否发生了异常。如果你希望在

__exit__

方法中处理掉这个异常(比如记录日志后不再向上层抛出),那么

__exit__

方法需要返回

True

。返回

True

会告诉 Python 解释器,这个异常已经被妥善处理了,不要再继续向上抛出。如果返回

False

(或者不返回任何值,因为默认就是

None

,相当于

False

),那么异常会继续传播。

举个例子,假设我们要实现一个简单的计时器上下文管理器:

import timeclass MyTimer:    def __enter__(self):        self.start_time = time.time()        print("计时开始...")        return self # 返回自身实例,这样 with MyTimer() as timer: 就可以用 timer 了    def __exit__(self, exc_type, exc_val, exc_tb):        end_time = time.time()        duration = end_time - self.start_time        print(f"计时结束,总耗时:{duration:.4f} 秒")        if exc_type: # 如果有异常发生            print(f"with 块内发生异常:{exc_type.__name__}: {exc_val}")            # 如果我们不想让异常继续传播,可以在这里返回 True            # return True        # 默认返回 None,即 False,异常会继续传播        print("资源清理完成。")# 使用示例with MyTimer():    print("正在执行一些耗时操作...")    time.sleep(1.5)    # raise ValueError("哦豁,出错了!") # 尝试解注释这行看看异常处理print("with 块外部代码继续执行。")

这里

__enter__

返回了

self

,所以

with MyTimer() as timer:

这里的

timer

就是

MyTimer

的实例。

__exit__

负责计算并打印耗时,同时展示了如何捕获异常信息。通过这样的设计,你可以封装任何需要“进入”和“退出”阶段的逻辑。

contextlib

模块如何简化上下文管理器的创建?

说实话,每次都写一个类,然后实现

__enter__

__exit__

,对于一些简单的上下文管理任务来说,确实有点小麻烦。Python 的标准库

contextlib

就是来解决这个问题的,它提供了一些工具,让创建上下文管理器变得更简单,特别是

@contextmanager

装饰器。

@contextmanager

装饰器允许你用一个生成器函数来创建上下文管理器。它的原理是,在生成器函数中,

yield

关键字之前的所有代码,相当于

__enter__

方法的逻辑;

yield

语句本身返回的值,就是

__enter__

方法的返回值;而

yield

语句之后的所有代码,则相当于

__exit__

方法的逻辑。

我们来用

@contextmanager

重新实现上面的计时器:

from contextlib import contextmanagerimport time@contextmanagerdef simple_timer():    start_time = time.time()    print("计时开始 (通过 contextlib)...")    try:        yield # 这里是 with 块的代码执行的地方    except Exception as e:        print(f"with 块内发生异常 (通过 contextlib):{type(e).__name__}: {e}")        # 如果要抑制异常,这里可以不 re-raise,或者捕获后不抛出        # 也可以再次抛出,或者抛出新的异常        raise # 默认会重新抛出捕获到的异常    finally:        end_time = time.time()        duration = end_time - start_time        print(f"计时结束 (通过 contextlib),总耗时:{duration:.4f} 秒")        print("资源清理完成 (通过 contextlib)。")# 使用示例with simple_timer():    print("正在执行一些耗时操作 (通过 contextlib)...")    time.sleep(0.8)    # raise TypeError("又出错了!") # 尝试解注释这行print("with 块外部代码继续执行 (通过 contextlib)。")

你看,是不是简洁多了?一个函数搞定一切。

yield

语句将生成器函数分割成了两个部分,完美地对应了

__enter__

__exit__

的行为。

try...except...finally

结构在

yield

周围,使得异常处理和清理逻辑变得非常直观。如果

yield

内部的代码抛出异常,这个异常会被

try...except

捕获,你可以在

except

块中处理它。如果

except

块没有重新抛出异常,那么异常就被抑制了。

finally

块则确保了清理代码无论如何都会执行。这种方式对于快速实现功能性上下文管理器,简直是神来之笔。

以上就是with 语句和上下文管理器(Context Manager)的原理的详细内容,更多请关注创想鸟其它相关文章!

版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容, 请发送邮件至 chuangxiangniao@163.com 举报,一经查实,本站将立刻删除。
发布者:程序猿,转转请注明出处:https://www.chuangxiangniao.com/p/1369766.html

(0)
打赏 微信扫一扫 微信扫一扫 支付宝扫一扫 支付宝扫一扫
上一篇 2025年12月14日 09:56:44
下一篇 2025年12月14日 09:57:02

相关推荐

  • CSS mask属性无法获取图片:为什么我的图片不见了?

    CSS mask属性无法获取图片 在使用CSS mask属性时,可能会遇到无法获取指定照片的情况。这个问题通常表现为: 网络面板中没有请求图片:尽管CSS代码中指定了图片地址,但网络面板中却找不到图片的请求记录。 问题原因: 此问题的可能原因是浏览器的兼容性问题。某些较旧版本的浏览器可能不支持CSS…

    2025年12月24日
    900
  • Uniapp 中如何不拉伸不裁剪地展示图片?

    灵活展示图片:如何不拉伸不裁剪 在界面设计中,常常需要以原尺寸展示用户上传的图片。本文将介绍一种在 uniapp 框架中实现该功能的简单方法。 对于不同尺寸的图片,可以采用以下处理方式: 极端宽高比:撑满屏幕宽度或高度,再等比缩放居中。非极端宽高比:居中显示,若能撑满则撑满。 然而,如果需要不拉伸不…

    2025年12月24日
    400
  • 如何让小说网站控制台显示乱码,同时网页内容正常显示?

    如何在不影响用户界面的情况下实现控制台乱码? 当在小说网站上下载小说时,大家可能会遇到一个问题:网站上的文本在网页内正常显示,但是在控制台中却是乱码。如何实现此类操作,从而在不影响用户界面(UI)的情况下保持控制台乱码呢? 答案在于使用自定义字体。网站可以通过在服务器端配置自定义字体,并通过在客户端…

    2025年12月24日
    800
  • 如何在地图上轻松创建气泡信息框?

    地图上气泡信息框的巧妙生成 地图上气泡信息框是一种常用的交互功能,它简便易用,能够为用户提供额外信息。本文将探讨如何借助地图库的功能轻松创建这一功能。 利用地图库的原生功能 大多数地图库,如高德地图,都提供了现成的信息窗体和右键菜单功能。这些功能可以通过以下途径实现: 高德地图 JS API 参考文…

    2025年12月24日
    400
  • 如何使用 scroll-behavior 属性实现元素scrollLeft变化时的平滑动画?

    如何实现元素scrollleft变化时的平滑动画效果? 在许多网页应用中,滚动容器的水平滚动条(scrollleft)需要频繁使用。为了让滚动动作更加自然,你希望给scrollleft的变化添加动画效果。 解决方案:scroll-behavior 属性 要实现scrollleft变化时的平滑动画效果…

    2025年12月24日
    000
  • 如何为滚动元素添加平滑过渡,使滚动条滑动时更自然流畅?

    给滚动元素平滑过渡 如何在滚动条属性(scrollleft)发生改变时为元素添加平滑的过渡效果? 解决方案:scroll-behavior 属性 为滚动容器设置 scroll-behavior 属性可以实现平滑滚动。 html 代码: click the button to slide right!…

    2025年12月24日
    500
  • 为什么设置 `overflow: hidden` 会导致 `inline-block` 元素错位?

    overflow 导致 inline-block 元素错位解析 当多个 inline-block 元素并列排列时,可能会出现错位显示的问题。这通常是由于其中一个元素设置了 overflow 属性引起的。 问题现象 在不设置 overflow 属性时,元素按预期显示在同一水平线上: 不设置 overf…

    2025年12月24日 好文分享
    400
  • 网页使用本地字体:为什么 CSS 代码中明明指定了“荆南麦圆体”,页面却仍然显示“微软雅黑”?

    网页中使用本地字体 本文将解答如何将本地安装字体应用到网页中,避免使用 src 属性直接引入字体文件。 问题: 想要在网页上使用已安装的“荆南麦圆体”字体,但 css 代码中将其置于第一位的“font-family”属性,页面仍显示“微软雅黑”字体。 立即学习“前端免费学习笔记(深入)”; 答案: …

    2025年12月24日
    000
  • 如何选择元素个数不固定的指定类名子元素?

    灵活选择元素个数不固定的指定类名子元素 在网页布局中,有时需要选择特定类名的子元素,但这些元素的数量并不固定。例如,下面这段 html 代码中,activebar 和 item 元素的数量均不固定: *n *n 如果需要选择第一个 item元素,可以使用 css 选择器 :nth-child()。该…

    2025年12月24日
    200
  • 使用 SVG 如何实现自定义宽度、间距和半径的虚线边框?

    使用 svg 实现自定义虚线边框 如何实现一个具有自定义宽度、间距和半径的虚线边框是一个常见的前端开发问题。传统的解决方案通常涉及使用 border-image 引入切片图片,但是这种方法存在引入外部资源、性能低下的缺点。 为了避免上述问题,可以使用 svg(可缩放矢量图形)来创建纯代码实现。一种方…

    2025年12月24日
    100
  • 如何解决本地图片在使用 mask JS 库时出现的跨域错误?

    如何跨越localhost使用本地图片? 问题: 在本地使用mask js库时,引入本地图片会报跨域错误。 解决方案: 要解决此问题,需要使用本地服务器启动文件,以http或https协议访问图片,而不是使用file://协议。例如: python -m http.server 8000 然后,可以…

    2025年12月24日
    200
  • 如何让“元素跟随文本高度,而不是撑高父容器?

    如何让 元素跟随文本高度,而不是撑高父容器 在页面布局中,经常遇到父容器高度被子元素撑开的问题。在图例所示的案例中,父容器被较高的图片撑开,而文本的高度没有被考虑。本问答将提供纯css解决方案,让图片跟随文本高度,确保父容器的高度不会被图片影响。 解决方法 为了解决这个问题,需要将图片从文档流中脱离…

    2025年12月24日
    000
  • 为什么我的特定 DIV 在 Edge 浏览器中无法显示?

    特定 DIV 无法显示:用户代理样式表的困扰 当你在 Edge 浏览器中打开项目中的某个 div 时,却发现它无法正常显示,仔细检查样式后,发现是由用户代理样式表中的 display none 引起的。但你疑问的是,为什么会出现这样的样式表,而且只针对特定的 div? 背后的原因 用户代理样式表是由…

    2025年12月24日
    200
  • inline-block元素错位了,是为什么?

    inline-block元素错位背后的原因 inline-block元素是一种特殊类型的块级元素,它可以与其他元素行内排列。但是,在某些情况下,inline-block元素可能会出现错位显示的问题。 错位的原因 当inline-block元素设置了overflow:hidden属性时,它会影响元素的…

    2025年12月24日
    000
  • 为什么 CSS mask 属性未请求指定图片?

    解决 css mask 属性未请求图片的问题 在使用 css mask 属性时,指定了图片地址,但网络面板显示未请求获取该图片,这可能是由于浏览器兼容性问题造成的。 问题 如下代码所示: 立即学习“前端免费学习笔记(深入)”; icon [data-icon=”cloud”] { –icon-cl…

    2025年12月24日
    200
  • 为什么使用 inline-block 元素时会错位?

    inline-block 元素错位成因剖析 在使用 inline-block 元素时,可能会遇到它们错位显示的问题。如代码 demo 所示,当设置了 overflow 属性时,a 标签就会错位下沉,而未设置时却不会。 问题根源: overflow:hidden 属性影响了 inline-block …

    2025年12月24日
    000
  • 如何利用 CSS 选中激活标签并影响相邻元素的样式?

    如何利用 css 选中激活标签并影响相邻元素? 为了实现激活标签影响相邻元素的样式需求,可以通过 :has 选择器来实现。以下是如何具体操作: 对于激活标签相邻后的元素,可以在 css 中使用以下代码进行设置: li:has(+li.active) { border-radius: 0 0 10px…

    2025年12月24日
    100
  • 为什么我的 CSS 元素放大效果无法正常生效?

    css 设置元素放大效果的疑问解答 原提问者在尝试给元素添加 10em 字体大小和过渡效果后,未能在进入页面时看到放大效果。探究发现,原提问者将 CSS 代码直接写在页面中,导致放大效果无法触发。 解决办法如下: 将 CSS 样式写在一个单独的文件中,并使用 标签引入该样式文件。这个操作与原提问者观…

    2025年12月24日
    000
  • 如何模拟Windows 10 设置界面中的鼠标悬浮放大效果?

    win10设置界面的鼠标移动显示周边的样式(探照灯效果)的实现方式 在windows设置界面的鼠标悬浮效果中,光标周围会显示一个放大区域。在前端开发中,可以通过多种方式实现类似的效果。 使用css 使用css的transform和box-shadow属性。通过将transform: scale(1.…

    2025年12月24日
    200
  • 为什么我的 em 和 transition 设置后元素没有放大?

    元素设置 em 和 transition 后不放大 一个 youtube 视频中展示了设置 em 和 transition 的元素在页面加载后会放大,但同样的代码在提问者电脑上没有达到预期效果。 可能原因: 问题在于 css 代码的位置。在视频中,css 被放置在单独的文件中并通过 link 标签引…

    2025年12月24日
    100

发表回复

登录后才能评论
关注微信