Pythonでmkdir -pと同じようにディレクトリを再帰的に作成する方法

mkdir -pとは？

UnixやLinuxのコマンドであるmkdir -pは、親ディレクトリが存在しない場合でも、必要な階層のディレクトリをまとめて一括作成できる便利なオプションです。また、指定したディレクトリがすでに存在していてもエラーにならず、そのまま処理が続行されます。

Pythonでmkdir -pと同等の処理を行うには

Pythonで同じことを実現するには、標準ライブラリのosモジュールにあるos.makedirs()関数を使用します。この関数に作成したいパスを渡すことで、中間の親ディレクトリも含めて再帰的にディレクトリを作成できます。

exists_ok=True を指定する

デフォルトでは、作成しようとしたディレクトリがすでに存在しているとFileExistsErrorが発生します。これを防ぐには、引数exists_ok=Trueを指定します。こうすることで、既存のフォルダがあってもエラーにならず、mkdir -pとまったく同じ挙動になります。

>>> import os
>>> os.makedirs('my_folder/another/folder', exists_ok=True)

動作のポイント

• 再帰的な作成： my_folder/another/folder のように、存在しない親ディレクトリも含めてすべて自動的に作成されます。
• 既存ディレクトリへの対応： exists_ok=True を付けることで、フォルダが既に存在していてもエラーを無視して処理を続けられます。

なお、Python 3.4以降では、より直感的なAPIを持つpathlib.Path.mkdir(parents=True, exist_ok=True)を使う方法もあります。用途に応じて使い分けるとよいでしょう。