Python NamedTemporaryFile 的 delete_on_close 怎么设置

用 tempfile.NamedTemporaryFile() 生成临时文件时，最容易混淆的是“文件对象关闭”和“临时路径清理”不是一回事。默认参数 delete=True, delete_on_close=True 会在 close() 时删除文件；如果要在 with 块内关闭它，再用 tmp.name 交给另一个读取器，通常应设置 delete_on_close=False。

先把两个删除参数分开理解

delete 决定“是否自动删除”，delete_on_close 决定“自动删除发生在 close() 还是 with 退出时”。后者从 Python 3.12 开始提供，不能把它写进需要兼容 Python 3.11 及更早版本的代码。

在 with 块内关闭后重新打开文件

下面的写法适合“先让生成器写入，再让只接受路径的工具读取”的场景。关键顺序是：先写完并刷新，调用 close() 释放当前句柄，再用文件名打开；离开 with 后，临时路径才会被清理。

from pathlib import Path
import tempfile

with tempfile.NamedTemporaryFile(
    mode="w",
    encoding="utf-8",
    delete=True,
    delete_on_close=False,
) as tmp:
    # 先写入并刷新，确保后续按路径打开时能读到完整内容
    tmp.write("批处理输入\n第二行数据\n")
    tmp.flush()
    temp_path = Path(tmp.name)
    tmp.close()  # 不删除：delete_on_close=False

    # 这里模拟只接收路径的下游处理器
    with temp_path.open("r", encoding="utf-8") as reader:
        # 重新打开的句柄必须在 with 外层退出前关闭
        text = reader.read()

# 退出外层 with 后，delete=True 会清理 temp_path

不要在外层 with 结束后再使用这个路径。它的存在时间只覆盖上下文内部；如果下游任务需要异步延后读取，应改用 delete=False，并在任务成功或失败的收尾分支中显式 unlink()。

Windows 与 POSIX 的边界不一样

POSIX 通常允许文件仍处于打开状态时再次按名称打开。Windows 对删除共享权限更严格：delete_on_close=False 可以让第二次 open() 更容易成功，但这个新句柄必须在外层上下文结束前关闭；否则包装器退出时执行删除可能失败。

如果目录本身不允许当前用户删除文件，Windows 也可能在上下文退出时抛出 PermissionError。这和 delete_on_close=True 的表现不同：后者会在创建时就申请删除权限，权限不足通常更早暴露。生产代码不要只在 Linux 上验证这条路径，至少把“重新打开”和“退出清理”各写一个跨平台测试。

按生命周期选择参数组合

• 只在当前 Python 文件对象里读写：使用默认配置，关闭即清理。
• 要把路径交给同一 with 内的外部库：使用 delete=True, delete_on_close=False，并保证外部句柄及时关闭。
• 要跨线程、跨进程或延迟任务读取：使用 delete=False，把清理责任放进明确的 try/finally。

import os
import tempfile

temp_path = ""
try:
    # delete=False 把生命周期交给业务代码，适合延迟读取
    with tempfile.NamedTemporaryFile(mode="wb", delete=False) as tmp:
        temp_path = tmp.name
        tmp.write(b"payload")
    # 这里可把 temp_path 交给稍后启动的任务
finally:
    if temp_path:
        # 清理动作放在 finally，避免异常路径遗留文件
        try:
            os.unlink(temp_path)
        except FileNotFoundError:
            pass

常见问题

delete_on_close=False 能单独保留文件吗？

不能。只有 delete=True 时它才决定删除时机；如果 delete=False，文件不会由包装器自动删除。

为什么关闭后再次 open 会找不到文件？

默认 delete_on_close=True 会在第一次 close() 时删除路径。需要复用路径时改成 delete_on_close=False，或明确使用 delete=False。

delete_on_close 是哪个 Python 版本新增的？

Python 官方文档标注它在 Python 3.12 加入。需要兼容更早版本时，应使用 delete=False 并自行清理，或重新设计句柄传递方式。

把 delete 看成总开关，把 delete_on_close 看成删除时机，就能避免“路径刚交给下游就消失”的问题。跨平台场景还要把第二个句柄的关闭时间和目录删除权限一起纳入设计。