Python tempfileの使い方|一時ファイル・一時フォルダ(tmp)の作り方と場所、消えない・Permission deniedの対処

Pythonで一時ファイルや一時フォルダ(tmp)を作るときは、標準ライブラリのtempfileを使います。迷ったらwith tempfile.TemporaryDirectory() as d:で作業用フォルダを作るのが基本で、withを抜けると中身ごと自動で削除されます。一時フォルダの場所はtempfile.gettempdir()で確認できます。

この記事では、tempfileの主な関数の使い分け、一時ファイルのパスを取り出して外部コマンドに渡す方法、/tmpの場所がOSでどう変わるか、削除されない・WindowsでPermissionErrorになるといったつまずきの直し方を、Python 3.12で実行した結果つきで説明します。各関数の細かい使い方は個別の記事に分けてあり、この記事はその入口です。

tempfileの関数早見表

やりたいこと 使う関数 自動削除 詳しい記事
作業用のフォルダがほしい(複数ファイル) TemporaryDirectory() withを抜けたとき TemporaryDirectory
パスのある一時ファイルを外部ツールに渡したい NamedTemporaryFile() 閉じたとき/withを抜けたとき NamedTemporaryFile
自分のプログラム内で読み書きするだけ TemporaryFile() 閉じたとき TemporaryFile
削除のタイミングを自分で決めたい mkstemp()/mkdtemp() しない mkstemp・mkdtemp
一時フォルダの場所を知りたい gettempdir() — この記事

基本はTemporaryDirectory:フォルダごと自動で消える

import tempfile, os
from pathlib import Path

with tempfile.TemporaryDirectory() as d:
    p = Path(d) / "work.txt"
    p.write_text("データ", encoding="utf-8")
    print("中身:", os.listdir(d))

print("抜けた後:", os.path.exists(d))

実行結果:

中身: ['work.txt']
抜けた後: False

dには作られたフォルダのパスが文字列で入ります。中に何個ファイルを作っても、withを抜けた時点でフォルダごと削除されるので、片付けを書く必要がありません。途中で例外が起きても削除されます。

一時ファイルを自分でopen("/tmp/work.txt", "w")のように作ると、同じプログラムを2つ同時に動かしたときに同じ名前を取り合う、例外で消し忘れる、Windowsに/tmpが無い、といった問題が起きます。tempfileは毎回ぶつからない名前を作り、OSごとの正しい場所に置いてくれます。

名前の付け方と置き場所を指定する

prefix・suffixで名前の前後を、dirで作る場所を指定できます。

with tempfile.TemporaryDirectory(prefix="report_", dir=".") as d:
    print(d)

実行結果(パスの途中は省略):

/…/tf/report_9866uiqn

dir="."と相対パスで指定しても、絶対パスで返ってきました。公式ドキュメントにも、Python 3.12からmkdtemp()は常に絶対パスを返すと書かれています(TemporaryDirectoryは内部でmkdtemp()を使います)。

調べるために消さずに残す(delete=False)

Python 3.12からはTemporaryDirectory(delete=False)で、withを抜けてもフォルダを残せます。デバッグで中身を確かめたいときに使えます。

with tempfile.TemporaryDirectory(delete=False) as d:
    pass
print("残る:", os.path.exists(d))

実行結果:

残る: True

残したフォルダは自分で削除します(shutil.rmtree()などの削除方法)。

一時ファイルのパスを取り出す(NamedTemporaryFile)

外部コマンドや別のライブラリに「ファイルのパス」を渡したいときは、NamedTemporaryFile()を使い、.nameでパスを取り出します。

import tempfile, os, subprocess

with tempfile.NamedTemporaryFile("w", suffix=".csv", encoding="utf-8",
                                 delete_on_close=False) as f:
    f.write("a,b\n1,2\n")
    f.close()                      # 書き込みを確定させる(まだ消えない)
    print("name:", f.name)
    out = subprocess.run(["wc", "-l", f.name], capture_output=True, text=True).stdout
    print("wc:", out.split()[0])

print("抜けた後:", os.path.exists(f.name))

実行結果:

name: /var/folders/yb/4fftqrh51fj0y8qjgb_jsbfh0000gn/T/tmpjo7wu9_2.csv
wc: 2
抜けた後: False

ポイントはdelete_on_close=False(Python 3.12で追加)です。これを付けないと、f.close()した瞬間にファイルが消えます。

with tempfile.NamedTemporaryFile("w") as f:
    f.close()
    print("closeした直後:", os.path.exists(f.name))

実行結果:

closeした直後: False

「書いて閉じてから別のプログラムに読ませ、最後はwithで消す」という流れには、delete_on_close=Falseが合っています。

WindowsでPermission deniedになるとき

公式ドキュメントによると、POSIX(macOS・Linux)では開いたままの一時ファイルを名前で開き直せますが、Windowsでは条件があります。delete=Falseにする、またはdelete=Trueのままdelete_on_close=Falseにする、などのどれかを満たさないと開き直せません。またdelete_on_close=Falseの場合でも、open()で別に開いたファイルはwithを抜ける前に閉じておかないと、削除時にPermissionErrorになります(tempfile — Generate temporary files and directories、2026年10月18日確認)。

Windowsで「一時ファイルを外部ツールに渡したらPermission denied」となったときは、上の例のようにdelete_on_close=Falseで作り、f.close()してからパスを渡すのが確実です。Python 3.11以前なら、delete=Falseで作って最後に自分でos.remove()します。

一時フォルダ(tmp)の場所を確認する:gettempdir()

import tempfile
print(tempfile.gettempdir())

実行結果(macOS):

/var/folders/yb/4fftqrh51fj0y8qjgb_jsbfh0000gn/T

macOSでは/tmpではなく、ユーザーごとの/var/folders/…/Tが返りました。公式ドキュメントでは、次の順で書き込める場所を探すと説明されています。

  1. 環境変数TMPDIR
  2. 環境変数TEMP
  3. 環境変数TMP
  4. OSごとの場所(Windowsは%USERPROFILE%\AppData\Local\Tempなど、それ以外は/tmp、/var/tmp、/usr/tmpの順)
  5. 最後の手段としてカレントディレクトリ

環境変数で場所を変えられることも確認しました。

$ TMPDIR=$PWD/mytmp python -c "import tempfile; print(tempfile.gettempdir())"
/…/tf/mytmp

コードに"/tmp"と直接書くと、Windowsで動かなかったり、利用者が指定した置き場所を無視したりします。場所が必要なときはgettempdir()で取得してください。

自動で消したくないときはmkstemp()・mkdtemp()

import tempfile, os

fd, path = tempfile.mkstemp(suffix=".txt")
with os.fdopen(fd, "w") as f:
    f.write("x")
print(oct(os.stat(path).st_mode & 0o777), os.path.exists(path))
os.remove(path)            # 自分で消す

d = tempfile.mkdtemp()
print(oct(os.stat(d).st_mode & 0o777))
os.rmdir(d)

実行結果:

0o600 True
0o700

mkstemp()は「ファイル記述子とパスの組」を返し、閉じても消えません。作られたファイルの権限は600、フォルダは700で、作成した本人しか読み書きできません。共有の一時フォルダに置かれても、ほかのユーザーに中身を読まれにくい作りになっています。

メモリ上で済ませたいならTemporaryFileやStringIO

パスが要らず、プログラムの中で書いて読み戻すだけならTemporaryFile()で足ります。

with tempfile.TemporaryFile("w+", encoding="utf-8") as f:
    f.write("hello")
    f.seek(0)
    print(f.read())

実行結果:

hello

データが小さいなら、ファイルを作らずにStringIOやBytesIOでメモリ上だけで扱う方法もあります。

テストでの使いどころ

ファイルを書き出す関数のテストでは、TemporaryDirectory()の中に出力させると、テストのたびに作業フォルダを片付ける処理が要りません。unittestならsetUp()で作ってaddCleanup()で片付ける形がよく使われます。テストの書き方は「Pythonのunittestの使い方」を参照してください。

よくある質問

Q. Pythonで/tmpにファイルを作るには?

パスを直接書かずにtempfileを使います。作業フォルダならtempfile.TemporaryDirectory()、パスのある1ファイルならtempfile.NamedTemporaryFile()を使うと、OSに合った一時フォルダにぶつからない名前で作られ、使い終わると自動で削除されます。

Q. 一時フォルダの場所はどこですか?

tempfile.gettempdir()で確認できます。環境変数TMPDIR・TEMP・TMPの順に見て、無ければWindowsはAppData\Local\Tempなど、macOS・Linuxは/tmpなどが使われます。macOSでは/var/folders/…/Tのようなユーザーごとの場所になることが多いです。

Q. NamedTemporaryFileを閉じたらファイルが消えてしまいます

既定ではclose()した時点で削除されます。Python 3.12以降はdelete_on_close=Falseを付けると、閉じても残り、withを抜けたときに削除されます。3.11以前はdelete=Falseで作り、最後にos.remove()で消します。

Q. 一時ファイルが削除されずに残っています

mkstemp()やmkdtemp()、delete=Falseで作ったものは自動では消えません。with文で使えるTemporaryDirectory()やNamedTemporaryFile()に置き換えるか、try/finallyで確実に削除してください。

まとめ

  • 一時ファイル・一時フォルダはtempfileで作る。/tmpを直接書かない
  • 迷ったらwith tempfile.TemporaryDirectory() as d:
  • パスを外部に渡すならNamedTemporaryFile(delete_on_close=False)+.name
  • 場所はgettempdir()。環境変数TMPDIRなどで変えられる
  • 自動で消さないmkstemp()・mkdtemp()は自分で削除する

あわせて読みたい

対面・無料|東京・永田町で毎週土曜日13時

1回の参加で、プログラミングの構造がわかる

ゼロからはじめるPython入門講座

8年間・累計600回開催/これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

  • 本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
  • 対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
  • 講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
  • 独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する|開催日程を見る

参加費は無料です