Pythonで複数のファイル名を再帰的に一括変更する方法

Pythonでは、os.walkを使ってディレクトリを再帰的に走査し、見つかったファイルに対してos.renameを適用することで、フォルダ内の複数のファイル名をまとめて変更できます。ここでは、特定の文字列を別の文字列に置き換える形でファイル名を一括リネームする方法を紹介します。

コード例

import os

def replace(folder_path, old, new):
    for path, subdirs, files in os.walk(folder_path):
        for name in files:
            if(old.lower() in name.lower()):
                file_path = os.path.join(path, name)
                new_name = os.path.join(path, name.lower().replace(old, new))
                os.rename(file_path, new_name)

使い方

この関数は次のように呼び出します。

replace('my_folder', 'IMG', 'Image')

このコードを実行すると、指定したフォルダとそのサブフォルダ内にあるすべてのファイルが再帰的に検索され、各ファイル名に含まれる「IMG」が「Image」に置き換えられます。

コードのポイント

• os.walk：指定したフォルダ以下を再帰的にたどり、現在のパス・サブディレクトリ・ファイル名の一覧を順番に返します。深い階層のファイルまで漏れなく処理できます。
• 大文字・小文字を区別しない判定：old.lower() in name.lower() とすることで、「img」「Img」「IMG」など表記ゆれのあるファイル名もすべてマッチさせることができます。
• os.path.join：OSごとに異なるパス区切り文字（Windowsの「\」やLinux/macOSの「/」）を自動的に処理するため、環境を問わず同じコードが動作します。

注意点

ファイル名の変更は基本的に元に戻せないため、実行前に重要なファイルのバックアップを取っておくことをおすすめします。また、変更後の名前がすでに存在するファイルと重複した場合は FileExistsError が発生するので、try-exceptによる例外処理を追加しておくとより安全です。

条件分岐や置換ルールを自分の用途に合わせてカスタマイズすれば、写真ファイルの整理やログファイルの一括リネームなど、さまざまな場面でこの手法を活用できます。