Python tempfile.NamedTemporaryFile 怎样安全创建临时文件

tempfile.NamedTemporaryFile() 适合“需要一个真实文件名，同时又希望临时文件自动清理”的场景。最常见的安全写法是用 with 管理生命周期；如果文件必须在关闭后按 name 再打开，则要明确设置 delete_on_close=False，Windows 下尤其如此。

官方地址：https://docs.python.org/3/library/tempfile.html#tempfile.NamedTemporaryFile

先分清可见路径和自动清理

TemporaryFile() 重点是临时存储，平台可能不保证目录中有一个可依赖的可见名称；NamedTemporaryFile() 则保证有文件名，并能通过 fp.name 交给另一个只接受路径的接口。两者都支持上下文管理器，但 NamedTemporaryFile 额外提供 delete 与 delete_on_close 两个删除控制项。

用 with 和关键参数创建文件

默认参数适合“打开、写入、读取，然后离开作用域”的短流程。prefix、suffix 和 dir 用来改善排查和目录控制；建议使用关键字参数，避免旧式参数顺序造成误读。

from pathlib import Path
import tempfile

work_dir = Path("/tmp")
with tempfile.NamedTemporaryFile(
    mode="w", encoding="utf-8", suffix=".json", prefix="job-", dir=work_dir
) as fp:
    # 在临时目录创建带后缀的文本文件，并让上下文退出负责删除。
    fp.write('{"status": "ready"}\n')
    fp.flush()
    # name 是可见路径，可传给只接受文件名的下游接口。
    print(fp.name)

这个例子没有把路径保存到长期状态中，因为上下文结束后文件会被删除。目录必须是调用进程可写的；在生产程序里可以把 dir 换成应用自己的临时工作目录，并避免把用户输入直接拼进文件名。

需要重开时处理 delete_on_close

如果下游工具只能在文件关闭后按路径打开，默认的 delete=True, delete_on_close=True 会让文件在关闭时消失。使用上下文管理器时，推荐把 delete_on_close 设为 False：先关闭当前句柄，再用 fp.name 重开，离开 with 时仍保留自动清理意图。

import tempfile

with tempfile.NamedTemporaryFile(mode="wb", delete_on_close=False) as fp:
    # 关闭当前句柄但暂不删除，让后续 open() 能按路径读取。
    fp.write(b"payload")
    fp.close()
    with open(fp.name, "rb") as reader:
        # 重新打开只用于读取，读取句柄必须在离开上下文前关闭。
        payload = reader.read()
    print(payload)
# with 退出后，NamedTemporaryFile 会尝试删除该临时文件。

在 POSIX 系统中，文件仍打开时通常可以再次打开；Windows 对删除共享更严格，至少要满足文档列出的条件之一。若选择 delete=False，就不要假设解释器会替你收尾，应在成功、异常和提前退出路径中显式删除。

收尾时检查平台和异常边界

还要注意三个边界：第一，Windows 退出上下文时如果其他句柄仍未关闭，删除可能抛出 PermissionError；第二，目录没有删除权限时，delete_on_close=False 的清理也可能失败；第三，POSIX 下进程被 SIGKILL 强制终止时，自动清理不能保证发生。临时文件包含敏感数据时，也不要把路径、内容或权限假设写入日志。

常见问题

为什么不用 tempfile.mktemp()？ 它把“生成名字”和“真正创建文件”拆开，两个动作之间可能被其他进程抢占；应使用 NamedTemporaryFile 或 mkstemp。

delete=False 后怎样清理？ 在所有下游读取句柄关闭后调用 os.unlink(fp.name)，并在异常处理路径中保留清理动作。

什么时候改用 TemporaryDirectory？ 当任务会产生多个临时文件并且它们有共同生命周期时，用临时目录包住这些文件，清理边界更清楚。