Pythonでディレクトリ内の複数ファイルの名前を一括変更するには？（os.renameとshutil.moveの使い方）

Pythonでディレクトリ内の複数のファイル名を変更したい場合、「現在のファイル名」と「新しいファイル名」の対応を辞書などで持っておけば、osモジュールのrename()メソッドを使って簡単に一括処理できます。

osモジュールのrename()を使う方法

import os

for old, new in files.items():  # Python 2では iteritems()
    os.rename(old, new)

os.rename(old, new)は、パスoldにあるファイルをnewという名前に変更します。なお、Windows環境では移動先に同名のファイルが存在するとエラーになるため、既存ファイルの上書きを許可したい場合は、Python 3.3以降で利用できるos.replace()を使うのが安全です。

shutilモジュールのmove()を使う方法

shutil（シェルユーティリティ）モジュールを利用する方法もあります。shutil.move(source, destination)を呼び出すと、sourceパスにあるファイルやフォルダがdestinationパスへ移動し、戻り値として新しい場所の絶対パスを文字列で返します。単純な名前変更だけでなく、別のディレクトリへの移動も同時に行えるのが特徴です。

import shutil

for old, new in files.items():  # Python 2では iteritems()
    shutil.move(old, new)

使い分けのポイント

• 同じディレクトリ内で名前だけ変更するなら、シンプルで高速なos.rename()がおすすめ
• 別ディレクトリへの移動を伴う場合や、柔軟な制御が必要な場合はshutil.move()が便利
• 既存ファイルの上書きが必要なケースではos.replace()を検討するとよい