tmp_path能自动清理临时文件，因为它是pytest函数级固件，每次测试创建唯一空临时目录，测试结束自动调用shutil.rmtree删除；作用域为function，返回pathlib.path实例，支持/拼接和write_text等操作。
pytest中临时文件不自动清理的典型表现
运行测试后，tmpdir 或 tmp_path 生成的文件夹还在磁盘上，尤其在 CI 环境或反复调试时，可能堆积大量 pytest-* 目录。这不是 bug，而是 pytest 的默认行为：它只保证测试运行期间路径可用，不负责退出后删除。
用 tmp_path 替代手动 tempfile.mkdtemp()
手动生成临时目录容易忘记 shutil.rmtree()，且无法享受 pytest 的自动生命周期管理。改用内置 fixture 是最稳妥的做法：
def test_something(tmp_path):
data_file = tmp_path / "input.txt"
data_file.write_text("hello")
# 测试逻辑...
assert data_file.read_text() == "hello"
# 测试结束，tmp_path 及其全部内容自动递归删除
-
tmp_path是pathlib.Path实例，比旧版py.path.local更现代、类型更明确 - 它在每个测试函数结束后自动清理，无需显式调用
.remove()或shutil.rmtree() - 若需跨测试复用（极少见），应改用
tmp_path_factory并自行控制生命周期
为什么不用 py.path.local？
py.path.local 在 pytest 6.0+ 已被标记为 deprecated，官方明确推荐迁移到 pathlib 原生对象。继续使用会导致：
Claw Code Suite (Python-Only Edition)
下载
仅使用 Python 将 Claw Code 虚拟化框架与 OpenClaw 集成，提供 184 种工具和 200 多条命令，用于安全分析和代码质量...
- 警告信息：
PytestDeprecationWarning: The py.path.local class is deprecated - 新版本 pytest 可能直接移除支持
-
py.path.local不兼容 Python 3.12+ 的某些路径语义（如符号链接解析）
需要保留某些临时文件时怎么办
偶尔调试需要查看生成的中间文件，可临时禁用清理，但必须显式处理：
def test_debug_with_persistence(tmp_path, request):
# 获取测试名用于命名输出目录
out_dir = tmp_path / f"debug_{request.node.name}"
out_dir.mkdir()
# ... 写入文件
if request.config.getoption("--keep-tmp", default=False):
# 手动将 tmp_path 移出 pytest 管理范围
import shutil
final_dir = out_dir.parent / "debug_artifacts" / request.node.name
final_dir.parent.mkdir(exist_ok=True)
shutil.move(str(out_dir), str(final_dir))
print(f"Debug files kept at: {final_dir}")
- 通过
--keep-tmp自定义命令行选项控制是否保留（需在conftest.py中注册） - 不能只靠
return tmp_path或打印路径就指望文件留下——pytest 仍会在 teardown 阶段删除整个tmp_path树 - 移动操作必须在测试函数返回前完成，否则
tmp_path的 parent 被删，shutil.move会失败
真正难的是跨测试共享临时资源时的清理边界——比如一个 session-scoped fixture 创建了数据库快照，又让多个测试写入临时文件。这种场景下，别依赖 pytest 自动清理，得自己写 teardown 逻辑，并确保异常发生时也能执行。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
