pytest 临时文件怎么隔离？用 tmp_path 避免测试互相污染

pytest 测试文件读写时，最容易出现的污染是多个测试共用一个工作目录和同一个文件名。单独运行能通过，整批运行却失败，通常是前一个测试留下的文件或修改了共享配置。tmp_path 为每个测试提供独立目录，本文用两个同名 report.txt 演示共享路径问题、fixture 组织方式和失败测试的定位方法。 为了便于复现，文中会把pytest 临时文件、tmp_path、测试隔离分别落到输入、判断和输出三个位置，并用边界样例说明何时应该接受、拒绝或继续排查；同时明确讨论fixture与文件测试。

一、先复现共享目录污染

测试函数如果直接写项目目录，会留下上次运行的 report.txt。第二个测试可能读到旧内容，测试顺序变化后结果也变化。先用最小函数写文件，再让两个测试使用同一固定路径，确认问题真实存在。

如果需要补齐基础概念，可先阅读pytest 文件测试教程，再回到下面的示例核对结果。

from pathlib import Path
def write_report(root, text):
    path=Path(root)/"report.txt"; path.write_text(text,encoding="utf-8"); return path

测试函数如果直接写项目目录，会留下上次运行的 report.txt。测试代码应把目标目录作为参数，业务函数不应偷偷依赖当前工作目录。

二、tmp_path为每个测试提供独立入口

tmp_path是pytest内置fixture，返回当前测试专属的Path。两个测试都可以使用report.txt，但路径不同；pytest负责在测试结束后管理临时目录。不要手工拼接系统临时目录，也不要让fixture返回字符串后到处转换。

def test_first(tmp_path):
    path=write_report(tmp_path,"first")
    assert path.read_text(encoding="utf-8")=="first"
def test_second(tmp_path):
    path=write_report(tmp_path,"second")
    assert path.read_text(encoding="utf-8")=="second"

tmp_path是pytest内置fixture，返回当前测试专属的Path。在断言中读取真实文件，才能同时验证写入路径和内容。

三、fixture负责准备输入和清理

当多个测试需要同一组初始文件，可以用fixture返回tmp_path下的文件；fixture不要指向项目固定目录。scope保持函数级别时隔离最强，改成module或session前要证明共享资源不会被修改。

如果需要补齐基础概念，可先阅读Python 3 教程，再回到下面的示例核对结果。

import pytest
@pytest.fixture
def sample_file(tmp_path):
    p=tmp_path/"input.csv"; p.write_text("id,value\n1,8\n",encoding="utf-8"); return p
def test_input(sample_file):
    assert sample_file.exists()

当多个测试需要同一组初始文件，可以用fixture返回tmp_path下的文件；fixture不要指向项目固定目录。fixture命名表达资源含义，测试失败时更容易读懂。

四、文件测试还要覆盖失败路径

文件存在并不代表内容有效。增加空文件、缺少表头、权限异常和重复运行用例；对不可写路径不要依赖操作系统偶然行为，可以用mock或只测试业务层收到的异常。测试输出中保留tmp_path，便于失败时定位临时文件。

def read_value(path):
    text=path.read_text(encoding="utf-8").strip()
    if not text: raise ValueError("文件为空")
    return text
def test_empty(tmp_path):
    p=tmp_path/"empty.txt"; p.write_text("",encoding="utf-8")
    import pytest
    with pytest.raises(ValueError): read_value(p)

文件存在并不代表内容有效。边界测试应说明预期异常类型和错误信息范围。

五、边界测试与排错记录

创建两个使用同名report.txt的测试，先用固定目录运行并记录污染，再改用tmp_path运行。用pytest -q单独执行和整批执行各一次；两次都应通过。随后把一个测试写入错误文件名，确认断言失败且输出包含临时路径。最后检查测试函数没有修改项目目录，避免把清理任务交给人工。

在“pytest 临时文件怎么隔离？用 tmp_path 避免测试互相污染”这个问题上，把测试结果按“输入、实际输出、预期输出、结论”记录下来；出现失败时保留原始错误和运行环境，不要只截取最后一行。脚本和测试往往会被重复运行，路径、处理器和临时目录不能依赖上一次运行留下的状态。

常见误区与选择建议

不要把tmp_path转成固定字符串后再拼接旧目录；不要为了复用数据把scope随意升到session；不要只断言文件存在而不验证内容；不要捕获所有异常后让测试静默通过。

落地检查清单

• 为pytest 临时文件准备一份最小正常输入和一份已知失败输入，先固定环境再比较结果。
• 检查tmp_path的边界，明确哪些情况应接受、拒绝或继续排查。
• 记录测试隔离的判断依据，避免错误被默认值、静默重试或格式化输出掩盖。
• 回归时一次只改一个变量，并把失败样例保留在测试目录。
• 交接时写明版本、命令、输入、输出和已知限制，让下一位维护者能复现结论。
• 对照正常输出与失败输出，确认错误信息能指出具体字段、路径、版本或状态，而不是只返回“失败”。
• 若规则发生变化，先更新样例和预期结果，再修改实现，避免测试通过但验收标准已经悄悄改变。
• 最后记录哪些情况尚未覆盖，把它们列为待确认项，不用默认值替代未知结论。

动手练习

1. 先运行正文中的正常样例，保存完整输出。
2. 只改变pytest 临时文件相关的一个输入，确认失败位置符合预期。
3. 再改变tmp_path，比较错误信息是否仍然可定位。
4. 关闭一项校验或配置，确认测试能够主动失败。
5. 恢复配置并重跑，检查结果是否回到基线。
6. 把一次失败记录整理成可交接的复现步骤。
7. 将尚未覆盖的边界加入下一轮回归清单。

结果怎么判读

• 输出符合预期且日志完整：记录为通过，并保留输入样例。
• 输出不符合预期但错误位置清楚：记录为可修复失败，先定位规则。
• 输出看似成功但缺少关键字段：不能放行，补充边界校验。
• 同一输入在不同环境结果不同：先比较版本、配置和依赖。
• 修改后正常样例通过、失败样例消失：优先检查错误是否被吞掉。
• 只有把pytest 临时文件、tmp_path和测试隔离的证据一起保存，结论才适合交接。

总结

tmp_path解决的是测试资源隔离，不是业务逻辑正确性。让业务函数接收目录，测试使用函数级临时路径，再配合空文件和异常用例，就能把顺序依赖变成可定位的失败。

延伸学习

1. pytest 临时文件基础：Python 入门课程
2. JSON 数据格式教程
3. Python 与 C/C++ 对比笔记

常见问题

Q：tmp_path每次都会清空吗？

A：每个测试获得独立路径，pytest负责生命周期；不要在测试间假定目录会保留。

Q：可以直接测试项目真实输出目录吗？

A：不建议。真实目录会让测试互相影响，除非这是专门的集成测试且有明确清理和隔离策略。