Pythonでディレクトリが存在しない場合にディレクトリを作成する方法

os.path.exists()で存在確認をしてから作成する基本の方法

ディレクトリを作成する際は、まず os.path.exists() を使って対象のディレクトリがすでに存在するかどうかを確認します。存在しない場合のみ作成することで、エラーを回避できます。

import os
if not os.path.exists('my_folder'):
    os.makedirs('my_folder')

この方法は直感的で分かりやすい反面、確認と作成の間に他のプロセスがディレクトリを作成してしまうと、まれに競合状態（レースコンディション）が発生する可能性があります。

EAFPスタイル：try-exceptで例外を処理する方法

Pythonでは「EAFP（Easier to Ask Forgiveness than Permission：許可を求めるより許しを請う方が容易）」というイディオムが推奨されることがあります。これは、事前に存在確認を行うのではなく、まず実行してみて、例外が発生したらそれを処理するというアプローチです。

import os
import errno
try:
    os.makedirs('my_folder')
except OSError as e:
    if e.errno != errno.EEXIST:
        raise

このコードでは、「ディレクトリが既に存在する」ことを示すエラー（errno.EEXIST）は無視し、それ以外のエラーが発生した場合には例外を再送出します。これにより、競合状態の問題も回避できます。

exist_ok=True を使うシンプルな方法（Python 3.2以降）

Python 3.2 以降では、os.makedirs() の exist_ok 引数を利用すると、さらに簡潔に記述できます。

import os
os.makedirs('my_folder', exist_ok=True)

ディレクトリが既に存在していてもエラーにならないため、存在チェックや例外処理のコードが不要になり、1行で目的を達成できます。現在のPythonでは、この方法が最も推奨されています。

pathlib を使ったモダンな方法

pathlib モジュールを使うと、パスをオブジェクトとして扱えるため、よりモダンで読みやすいコードになります。

from pathlib import Path
Path('my_folder').mkdir(parents=True, exist_ok=True)

parents=True を指定すると、存在しない親ディレクトリもまとめて作成されます。exist_ok=True により、ディレクトリが既に存在していてもエラーにはなりません。

まとめ

ディレクトリの作成方法としては、古いPythonバージョンとの互換性が必要な場合を除き、os.makedirs(path, exist_ok=True) または pathlib.Path.mkdir(parents=True, exist_ok=True) を使うのが最もシンプルで安全です。状況に応じて適切な方法を選択しましょう。