当前位置:首页>python>Python语言基础:18_ with 关键字

Python语言基础:18_ with 关键字

  • 2026-10-11 05:43:19
Python语言基础:18_ with 关键字

with 是 Python 专门用来自动管理资源的语法糖,你可以把它理解成一个「智能借还工具」:

  1. 进入 with 代码块:自动帮你申请 / 打开资源(比如打开文件、连上数据库、加锁)
  2. 在 with 内部:你正常使用资源
  3. 离开 with 代码块:自动帮你释放 / 关闭资源 哪怕代码中途报错崩溃,它也会老老实实把资源释放掉,绝不会出现「资源泄漏」的问题。

本文从痛点引入,到基础用法、底层原理、实战场景、自定义写法,全程配可运行示例,零基础也能完全看懂。


一、先搞懂:为什么必须用 with?(痛点引入)

我们操作文件、数据库、网络连接这类「系统资源」时,流程永远是三步:

  1. 打开 / 申请资源
  2. 使用资源
  3. 关闭 / 释放资源

如果忘记第三步,资源会一直占用系统内存,操作多了会导致程序卡顿、崩溃。

1. 传统写法的致命问题

手动打开、手动关闭,一旦中间代码报错,close() 就永远没机会执行:

# 传统写法:手动管理文件f = open("test.txt", "w", encoding="utf-8")f.write("Hello Python")# 👇 如果上面的代码中途报错,这行永远不会执行,文件就一直开着# 比如把上面改成 f.write(123),类型错误直接崩,close() 就跳过了f.close()

2. 补救写法:try...finally

为了保证资源一定被关闭,我们可以用 try...finally,哪怕报错也会执行 finally 里的关闭代码:

f = open("test.txt", "w", encoding="utf-8")try:    f.write("Hello Python")    1 / 0  # 故意造一个错误,模拟程序崩溃finally:    print("执行关闭文件操作")    f.close()  # 无论是否报错,这行一定会执行

运行后你会发现:哪怕程序报错,f.close() 依然会执行,文件能正常关闭。

但问题也很明显:每次操作资源都要手写 try...finally,代码臃肿又麻烦。 👉 with 关键字就是专门用来简化这个流程的 —— 自动帮你做「申请 + 异常保护 + 释放」全套操作。


二、with 基础用法(最常用:文件操作)

with 最核心、新手最高频的使用场景,就是文件读写,操作文件一律推荐用 with。

1. 语法格式

with 资源对象 as 变量名:    # 缩进内部:使用资源的代码    业务逻辑代码
  • 资源对象
    :必须是支持「上下文管理器协议」的对象(比如 open() 返回的文件对象)
  • as 变量名
    :把资源对象赋值给变量,方便在内部操作
  • 缩进块结束:自动释放资源

2. 完整示例:写文件

# 用with打开文件,自动管理with open("test.txt", "w", encoding="utf-8") as f:    f.write("你好,with关键字")    f.write("\n不用手动写close,太方便了")# 👇 出了缩进块,文件已经自动关闭了print("程序执行结束")

3. 验证:文件真的被关闭了

在 with 外面再尝试操作文件,会直接报错,证明资源已经被释放:

withopen("test.txt", "w", encoding="utf-8") as f:    f.write("测试关闭")# 尝试在外部写文件,会报错:I/O operation on closed file.f.write("再写一行")

4. 读文件示例

with open("test.txt", "r", encoding="utf-8") as f:    content = f.read()    print("文件内容:", content)# 读取完成,文件自动关闭

💡 新手记住:只要是操作文件,一律用 with 写法,永远不会忘关文件。


三、核心原理:上下文管理器

with 之所以能自动管理资源,底层靠的是上下文管理器(Context Manager)。

1. 什么是上下文管理器

只要一个类实现了下面两个特殊方法,它就是上下文管理器,就能配合 with 使用:

方法
触发时机
作用
__enter__(self)
进入 with 块时自动调用
申请资源,返回值会赋值给 as 后面的变量
__exit__(self, exc_type, exc_val, exc_tb)
离开 with 块时自动调用
释放 / 清理资源,无论代码是否报错都会执行

简单说:

  • __enter__
     = 打开资源
  • __exit__
     = 关闭资源
  • with
     = 自动调用这两个方法,顺便帮你处理异常

2. 自定义一个最简单的上下文管理器

我们自己写一个类,直观看到两个方法的执行顺序:

class MyTool:    def __enter__(self):        print("✅ 进入with块,自动打开资源")        # 返回的值会交给 as 后面的变量        return "我是工具对象"    def __exit__(self, exc_type, exc_val, exc_tb):        print("❌ 离开with块,自动关闭资源")        # 三个参数说明(新手了解即可):        # exc_type:异常类型;exc_val:异常值;exc_tb:异常追踪栈        # 没报错时三个都是None;报错时会传入异常信息        # 返回False:异常继续往外抛;返回True:抑制异常,程序不崩溃        return False

正常运行测试

with MyTool() as tool:    print("正在使用:", tool)    print("执行业务逻辑代码")print("程序全部结束")

运行结果:

✅ 进入with块,自动打开资源正在使用: 我是工具对象执行业务逻辑代码❌ 离开with块,自动关闭资源程序全部结束

异常场景测试

哪怕 with 内部代码报错,__exit__ 依然会执行:

with MyTool() as tool:    print("正在使用:", tool)    1 / 0  # 故意制造错误    print("这行代码永远不会执行")print("程序结束")

运行结果:

✅ 进入with块,自动打开资源正在使用: 我是工具对象❌ 离开with块,自动关闭资源Traceback (most recent call last):  ...ZeroDivisionError: division by zero

可以看到:程序虽然报错了,但「自动关闭资源」的代码依然执行了,这就是 with 最核心的价值。


四、with 的常见使用场景

除了文件操作,Python 很多内置对象和第三方库都支持上下文管理器,都是高频实用场景。

1. 文件操作(最核心)

  • 普通文本文件读写
  • 二进制文件(图片、视频)读写
  • CSV、JSON 文件处理

2. 线程锁:保证多线程安全

多线程操作共享资源时,用 with 自动加锁、解锁,避免手动写 lock.acquire() / lock.release():

import threadinglock = threading.Lock()# 进入自动加锁,离开自动解锁with lock:    # 这里的代码同一时间只有一个线程能执行    print("操作共享资源")

3. 数据库连接 / 游标

操作数据库时,自动管理连接、自动提交 / 回滚事务:

import sqlite3# 退出with时自动提交事务、关闭连接with sqlite3.connect("test.db") as conn:    cursor = conn.cursor()    cursor.execute("CREATE TABLE IF NOT EXISTS user(id INT, name TEXT)")

4. 压缩文件处理

import zipfile# 自动打开、自动关闭压缩包with zipfile.ZipFile("test.zip", "r") as zf:    zf.extractall("./解压目录")

5. 临时目录 / 临时文件

tempfile 模块创建临时文件,用完自动删除:

import tempfilewith tempfile.TemporaryFile() as tmp:    tmp.write(b"临时数据")    # 退出with后,临时文件自动删除

五、进阶用法

1. 同时管理多个资源

with 支持一行同时写多个资源,用逗号分隔,不用嵌套多层 with:

# 把源文件的内容复制到目标文件with open("源文件.txt", "r", encoding="utf-8") as f1, \     open("目标文件.txt", "w", encoding="utf-8") as f2:    content = f1.read()    f2.write(content)

等价于嵌套写法,但更简洁:

with open("源文件.txt", "r") as f1:    with open("目标文件.txt", "w") as f2:        f2.write(f1.read())

2. 简化自定义:contextlib 装饰器

如果只是简单的自定义上下文管理器,不用写类,用 contextlib.contextmanager 装饰器 + 生成器就能实现,代码更短:

from contextlib import contextmanager@contextmanagerdef my_tool():    # yield 前面的代码:相当于 __enter__    print("打开资源")    res = "工具对象"    yield res  # yield 的值 = __enter__ 的返回值    # yield 后面的代码:相当于 __exit__    print("关闭资源")

使用方式和类完全一样:

withmy_tool() as t:    print("使用中:", t)

运行结果:

打开资源使用中: 工具对象关闭资源

💡 新手提示:简单场景用装饰器写法更方便,复杂场景还是用类实现更清晰。


六、新手高频易错点总结

  1. 漏掉冒号、缩进错误with
     行尾必须加英文冒号,内部代码必须缩进 4 个空格,规则和 if/for/while 完全一致。
  2. 在 with 块外使用资源
     出了缩进块资源已经被释放,再调用文件的读写方法会直接报错。
  3. 不是所有对象都能用 with
     只有实现了上下文管理器协议的对象才可以,比如 with 123 as x: 会直接报错。
  4. as 可以省略 如果不需要拿到资源对象,可以不写 as:

    # 只创建文件,不需要操作内容with open("空文件.txt", "w"):    pass
  5. 不要手动重复关闭
     不要在 with 块里手动写 f.close(),退出时会自动关闭,多此一举还可能引发异常。

最新文章

随机文章