【Python入門】shutilモジュールでファイルを別フォルダにコピーする方法

Pythonでファイルをコピーしたいときに便利なのが、標準ライブラリのshutilモジュールです。shutilモジュールを使えば、単一のファイルはもちろん、フォルダ全体をまとめてコピーすることもできます。

複数のファイルを一度にコピーする場合は、コピー対象となるファイル名をリストにまとめておき、for文などのループ処理で順番にコピーしていくのが基本のやり方です。

shutil.copy() の基本的な使い方

shutil.copy(source, destination) を呼び出すと、source パスにあるファイルが、destination パスで指定したフォルダへコピーされます。引数の source と destination は、どちらも文字列で指定します。

• destination にフォルダ名を指定した場合： 元のファイル名のまま、そのフォルダ内にコピーされます。
• destination にファイル名を指定した場合： 指定した名前がコピー先での新しいファイル名として使用されます。
• 戻り値： コピーされたファイルのパスが文字列として返されます。

サンプルコード：複数のファイルを一括コピーする

以下は、「file1.txt」「file2.txt」「file3.txt」の3つのファイルを「dest_folder」フォルダへまとめてコピーする例です。

import shutil, os

files = ['file1.txt', 'file2.txt', 'file3.txt']

for f in files:
    shutil.copy(f, 'dest_folder')

補足ポイント

コピー先のフォルダが存在しないとエラーになるため、事前に os.makedirs('dest_folder', exist_ok=True) などでフォルダを作成しておくと安心です。また、ファイルの更新日時などのメタデータも一緒にコピーしたい場合は、shutil.copy2() を使うとよいでしょう。