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が返りました。公式ドキュメントでは、次の順で書き込める場所を探すと説明されています。
- 環境変数
TMPDIR - 環境変数
TEMP - 環境変数
TMP - OSごとの場所(Windowsは
%USERPROFILE%\AppData\Local\Tempなど、それ以外は/tmp、/var/tmp、/usr/tmpの順) - 最後の手段としてカレントディレクトリ
環境変数で場所を変えられることも確認しました。
$ 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()は自分で削除する



![Permission deniedの意味と直し方|PythonのPermissionError: [Errno 13]・zsh・Macの原因別チェック Gemini_Generated_Image_rrfimprrfimprrfi](/wp-content/uploads/2026/09/Gemini_Generated_Image_rrfimprrfimprrfi-150x150.jpg)

