with 是 Python 专门用来自动管理资源的语法糖,你可以把它理解成一个「智能借还工具」:
- 进入
with 代码块:自动帮你申请 / 打开资源(比如打开文件、连上数据库、加锁) - 离开
with 代码块:自动帮你释放 / 关闭资源 哪怕代码中途报错崩溃,它也会老老实实把资源释放掉,绝不会出现「资源泄漏」的问题。
本文从痛点引入,到基础用法、底层原理、实战场景、自定义写法,全程配可运行示例,零基础也能完全看懂。
一、先搞懂:为什么必须用 with?(痛点引入)
我们操作文件、数据库、网络连接这类「系统资源」时,流程永远是三步:
如果忘记第三步,资源会一直占用系统内存,操作多了会导致程序卡顿、崩溃。
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) | | |
__exit__(self, exc_type, exc_val, exc_tb) | | |
简单说:
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. 文件操作(最核心)
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)
运行结果:
💡 新手提示:简单场景用装饰器写法更方便,复杂场景还是用类实现更清晰。
六、新手高频易错点总结
- 漏掉冒号、缩进错误
with 行尾必须加英文冒号,内部代码必须缩进 4 个空格,规则和 if/for/while 完全一致。 - 在 with 块外使用资源 出了缩进块资源已经被释放,再调用文件的读写方法会直接报错。
- 不是所有对象都能用 with 只有实现了上下文管理器协议的对象才可以,比如
with 123 as x: 会直接报错。 as 可以省略 如果不需要拿到资源对象,可以不写 as:
# 只创建文件,不需要操作内容with open("空文件.txt", "w"): pass
- 不要手动重复关闭 不要在
with 块里手动写 f.close(),退出时会自动关闭,多此一举还可能引发异常。