【初心者向け】Pythonでファイルをコピーする方法を徹底解説

Pythonでファイルをコピーする基本の方法

Pythonでファイルやフォルダをコピーするには、標準ライブラリのshutilモジュールを使用します。shutilモジュールには、単一のファイルだけでなく、フォルダ全体をまとめてコピーするための関数も用意されており、追加インストールなしですぐに利用できます。

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

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

ポイントは以下の通りです。

• コピー先にファイル名を指定した場合は、その名前がコピー後の新しいファイル名として使用される
• コピー先にフォルダのパスを指定した場合は、元のファイル名のままそのフォルダ内にコピーされる
• この関数は、コピーされたファイルのパスを文字列として返す

>>> import shutil
>>> # 同じフォルダ内に別名でコピーする例
>>> shutil.copy('original.txt', 'duplicate.txt')
'/home/username/duplicate.txt'
>>> # 別のフォルダへコピーする例
>>> shutil.copy('original.txt', 'my_folder/duplicate.txt')
'/home/username/my_folder/duplicate.txt'

メタデータごとコピーしたい場合：shutil.copy2()

shutil.copy() はファイルの内容のみをコピーします。作成日時や更新日時などのメタデータまで含めてコピーしたい場合は、shutil.copy2() を使いましょう。使い方は copy() とまったく同じですが、バックアップ用途などではこちらが推奨されます。

フォルダ全体をコピーする場合：shutil.copytree()

フォルダ（ディレクトリ）の中身を丸ごとコピーしたいときは、shutil.copytree(コピー元, コピー先) を使用します。指定したフォルダ内のすべてのファイルとサブフォルダが再帰的にコピーされ、フォルダ構造がそのまま再現されます。

>>> import shutil
>>> shutil.copytree('src_folder', 'dst_folder')
'dst_folder'

このように、shutilモジュールを使えば、ファイル単位からフォルダ単位まで、さまざまなコピー操作をシンプルなコードで実現できます。