Pythonでファイルを削除する方法をパターン別に解説

Pythonでファイル・ディレクトリを削除するにはどうすればいいの?
ファイル・ディレクトリをまとめて削除するにはどうすればいいの?
ファイルの削除に失敗した場合の対処法は?

Pythonでファイルを扱っている場合、このような問題に直面することもあると思います。

そこで、ここではPythonでファイルやディレクトリを削除する方法について、ファイル名を指定して削除する方法や、ファイルをワイルドカードを使用してまとめて削除する方法などについて解説していきます。

  • ファイル名を指定して削除する方法
  • ファイルを複数まとめて削除する方法
  • ディレクトリを削除する方法
  • 削除時にエラーが発生した場合の対処法

ファイルを扱う操作は実際の開発でもよく行いますので、この機会にぜひ覚えておきましょう!

Pythonでファイルを削除する方法

指定したファイルを削除

ファイルを削除するには、osモジュールのremove関数を使用します。

【書き方】

import os
os.remove(file)

ファイルの指定は絶対パスと相対パスどちらでも可能です。では実際にプログラムと同じディレクトリにあるsample.txtを削除する方法を紹介します。

サンプルプログラム:

import os
os.remove("sample.txt")

このように記述するだけで簡単にファイルを削除することができます。また、絶対パスでフルパスを指定して削除することも可能です。

サンプルプログラム:

import os
os.remove("/Users/taka/python/sample.txt")

このように削除対象のファイルがPythonプログラムと違うディレクトリに存在する場合は、パスを指定して削除することができます。

複数のファイルを削除

ファイルやを削除するremove関数ですが、複数のファイルをまとめて削除することはできません。では複数のファイルまとめて削除するにはどうすれば良いでしょうか?

たとえば、「sample1.txt〜sample3.txt」というファイルをまとめて削除したい場合、簡単な方法としてはglobモジュールのglob関数で正規表現を使用して一致するファイルをリストで取得します。

そして、リストで取得したオブジェクトを繰り返し処理で1つずつremove関数でファイル削除を実行すれば、複数のファイルを削除することができます。以下にファイルの一覧をリストに取得後、まとめて削除する方法を紹介します。

サンプルプログラム:

import glob
import os
 
file_list = glob.glob("sample*txt")

for file in file_list:
    print("remove:{0}".format(file))
    os.remove(file)

実行結果:

remove:sample1.txt
remove:sample2.txt
remove:sample3.txt

このようにまとめて削除することができました。ここではglob関数の引数に*「ワイルドカード」を使用して、sampleという文字列に一致したtxtファイルが存在したらまとめて削除しています。後述するディレクトリも同じ要領で削除することができます。

また、拡張子「.txt」のファイルをまとめて削除したい場合は、glob関数で正規表現で「*.txt」と指定すればOKです。

ディレクトリを削除する方法

空のディレクトリを削除する

空のディレクトリを削除するにはosモジュールのrmdir関数を使用します。

以下の例ではディレクトリsubdirを指定して削除しています。サンプルプログラム:

import os
os.rmdir("subdir")

注意点として、rmdir関数は空のディレクトリのみ削除することができます。ディレクトリにファイルやサブディレクトリが存在する場合はエラーが発生しますので注意しましょう。

ディレクトリ全体を削除する

ディレクトリに含まれるファイルやサブディレクトリをまるごと削除するには、shutilモジュールのrmtree関数を使用します。

サンプルプログラム:

import shutil
shutil.rmtree("subdir")

rmtree関数はディレクトリ全体を削除してしまうため、もし削除されたくないファイルなどが存在する場合は注意しましょう。

削除に失敗した場合の対処法

ファイルやディレクトリの削除に失敗した場合、以下のような原因が考えられます。

  • パスが存在しない
  • ファイルが存在しない
  • ディレクトリが存在しない

そのため、削除処理を行う前に存在チェックを行うことをおすすめします。以下にそれぞれチェック方法について紹介します。

パスの存在確認

指定したパスにファイルが存在するか確認したい場合は、osモジュールpath.exists関数を使用します。

サンプルプログラム:

import os
print(os.path.exists("/Users/taka/python/sample.txt"))

実行結果:

True

ここでは指定した「/Users/taka/python/sample.txt」が存在するためtrueを返しています。

ファイルの存在確認

削除対象のファイルがファイルとして存在・認識されているか確認する場合はpath.isfile関数を使用します。

サンプルプログラム:

import os
print(os.path.isfile("/Users/taka/python/sample.txt"))

実行結果:

True

ディレクトリの存在確認

削除対象のディレクトリがディレクトリとして存在・認識されているか確認する場合はpath.isdir関数を使用します。

import os
print(os.path.isdir("/Users/taka/python/sub"))

実行結果:

True

さまざまなファイルの操作方法

Pythonにはファイルを操作するさまざまな方法があります。

以下の記事ではファイルの削除・名前の変更・更新日の確認・ファイルの存在有無などのファイル処理について紹介しています。気になる方はぜひ参考にしてみてくださいね!

まとめ

ここでは、Pythonでファイル・ディレクトリを削除する方法を解説しました。ファイル・ディレクトリの削除はosモジュールの関数をそれぞれ使えば簡単に削除できることがわかりました。

また、複数のファイルを削除する場合や削除に失敗した場合の対処法についても解説しました。もし、ファイル・ディレクトリを削除する方法を忘れてしまったら、この記事を思い出してくださいね!

LINEで送る
Pocket

ITエンジニアへ転職したい方におすすめ

自分を評価してくれる企業に転職して年収を上げたい! 自分のスキルにあった独自案件を知りたい!
エンジニアは今もっとも注目されている職業の1つ。エンジニアになって年収を増やしたい方や、あなたのスキルに見合った企業へ転職したいエンジニアの方も多いですよね。

しかし、大手の転職媒体は扱う求人数が多くても、誰もが登録しているので競争率もかなり高くなっています。そのため、あなたの条件に見合った企業を見つけても転職するためには、相応の努力とスキルが必要となります。

こういった媒体では、未経験からエンジニアを目指す方やエンジニア歴2〜3年で転職を考えている方にとって、最適な転職環境とはいえません。

そこでオススメしたいのが、未経験者や若手エンジニア向けの独自案件を多く掲載している「侍ワークス」です。

侍ワークスは、独自案件を多く掲載しているだけでなく、

・応募から就業まで一貫したサポート

・就業後もアフターフォロー

といった経験の浅い方や初めてエンジニアを目指す方にも安心のフォロー体制が整っています。もちろん登録は完全無料!しかも案件を見るだけなら登録も不要です。

まずは、お気軽にどんな求人があるか見てみてください。あなたにピッタリの企業がきっと見つかりますよ! 侍ワークスの求人情報を見る

書いた人

ヤマシタ

システムエンジニアとして10年勤務→フリーランスへ。現在は侍ブログ編集部としてこれまでに200記事以上の記事を執筆。
大規模システム開発からWebアプリ開発まで経験あり。最近ではPythonの機械学習に挑戦中。