Python pytest如何清理测试产生的临时文件_利用tmp_path固件自动销毁-Python教程-PHP中文网

tmp_path能自动清理临时文件，因为它是pytest函数级固件，每次测试创建唯一空临时目录，测试结束自动调用shutil.rmtree删除；作用域为function，返回pathlib.Path实例，支持/拼接和write_text等操作。

python pytest如何清理测试产生的临时文件_利用tmp_path固件自动销毁

tmp_path固件为什么能自动清理临时文件

因为 tmp_path 是 pytest 内置的函数级固件（fixture），每次测试运行时都会创建一个全新的 pathlib.Path 对象，指向一个空的、唯一的临时目录；测试函数退出后（无论成功或失败），pytest 会自动调用 shutil.rmtree 删除该目录及其全部内容。

它不依赖 try/finally 或 yield，也不需要手动注册 teardown 逻辑——只要你在测试函数签名里声明了 tmp_path 参数，清理就自动发生。

作用域是函数级（scope="function"），每个测试独享一份，互不干扰
路径基于系统临时目录（如 /tmp/pytest-of-user/...），不污染项目根目录
返回的是 pathlib.Path 实例，不是字符串，直接支持 / 拼接、.write_text() 等现代写法

怎么在测试里安全地创建和使用临时文件

别自己调用 tempfile.mktemp() 或拼接 os.path.join(tempfile.gettempdir(), ...) —— 这些绕过 pytest 生命周期，文件不会被自动清理，还可能因并发测试导致命名冲突。

正确做法是直接用 tmp_path 创建子路径：

def test_saves_config_file(tmp_path):
    config_file = tmp_path / "config.json"
    config_file.write_text('{"host": "localhost"}')
<pre class="brush:php;toolbar:false;"># 调用被测函数，传入 config_file
result = load_config(config_file)

assert result["host"] == "localhost"
# 测试结束，tmp_path 及其下所有内容（包括 config.json）已被删除

避免用 str(tmp_path) 再转回 Path，直接用 / 操作符更简洁
如果需要子目录，用 tmp_path / "subdir" / "file.txt"，目录会自动按需创建（write_text 和 mkdir 都支持 exist_ok=True）
不要在测试外保存 tmp_path 引用（比如赋值给模块变量），它只在当前测试生命周期内有效

tmp_path vs tmp_path_factory：什么时候该用后者

tmp_path 够用，除非你遇到这两个场景：

Shadows Python Sensei

Python 最佳实践助手——代码规范、设计模式、性能优化、测试与类型注解。适用于编写或审查 Python 代码。

下载

需要在模块级或会话级固件中创建临时路径（比如启动一次数据库服务，多个测试共用同一个临时数据目录）
想为不同测试生成隔离但可预测的路径名（例如固定后缀：tmp_path_factory.mktemp("cache")）

此时必须用 tmp_path_factory，它是会话级固件，提供 mktemp() 方法：

@pytest.fixture(scope="module")
def shared_data_dir(tmp_path_factory):
    return tmp_path_factory.mktemp("shared_data")
<p>def test_imports_from_shared_dir(shared_data_dir):
(shared_data_dir / "input.csv").write_text("a,b\n1,2")
run_import(shared_data_dir)
</p>

注意：tmp_path_factory.mktemp() 创建的目录**不会自动清理**——pytest 只负责清理 tmp_path，不追踪你手动用 mktemp() 造出来的路径。你得自己加 yield + shutil.rmtree，或者改用 tmp_path 的模块级变体 tmp_path_factory 配合显式 teardown。

常见误用和静默失效点

最常踩的坑不是“没清理”，而是“以为清理了，其实没生效”：

测试函数没声明 tmp_path 参数 → 固件根本没被调用，临时文件留在系统里
用了 tempfile.TemporaryDirectory() 并手动 .cleanup() → 和 pytest 无关，且容易漏掉异常分支下的清理
在测试中修改了 os.chdir(tmp_path) 但没切回来 → 后续测试可能在错误路径下创建文件，tmp_path 仍会被删，但那些“跑偏”的文件不会
用 subprocess.run(..., cwd=tmp_path) 启动子进程写文件 → 子进程退出后文件还在，但 tmp_path 仍会被删（这是预期行为）；若子进程后台持续运行，目录删除会失败（Linux 可能报 Device or resource busy）