Pythonでディレクトリやファイルを削除する方法を現役エンジニアが解説【初心者向け】

初心者向けにPythonでディレクトリやファイルを削除する方法について解説しています。os.removeメソッドの場合は、ディレクトリにファイルがある場合はディレクトリの削除は出来ませんが、shutil.rmtreeメソッドでは一括で削除出来てしまいます。便利ですが注意して使用する必要があります。

TechAcademyマガジンはオンラインのプログラミングスクールTechAcademy [テックアカデミー]が運営する教育×テクノロジーのWebメディアです。初心者でもすぐ勉強できる記事が2,000以上あります。

Pythonでディレクトリやファイルを削除する方法について解説します。

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事をまずご覧ください。

 

なお本記事は、TechAcademyのPythonオンライン講座の内容をもとにしています。

 

田島悠介

今回は、Pythonに関する内容だね!

大石ゆかり

どういう内容でしょうか?

田島悠介

ディレクトリやファイルを削除する方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

os.remove でファイルを削除する方法

os.removeは指定したファイルを削除します。os.removeはディレクトリを削除できません。

ディレクトリを削除する場合には、os.rmdirを用います。ただし、os.rmdirが削除できるのは空のディレクトリのみです。

shutil.rmtree でディレクトリを削除する方法

shutil.rmtreeは指定したディレクトリ以下を再帰的に削除します。

指定したディレクトリがファイルや子ディレクトリを含んでいる場合、それらも削除します。

中身も含めディレクトリを削除したい場合に便利です。

 

[PR] Pythonで挫折しない学習方法を動画で公開中

実際に書いてみよう

サンプルコード os.remove

os.removeで、ファイルabc、ディレクトリdefの削除を試みます。

import os

target_file = 'abc'

print(os.path.exists(target_file))
os.remove(target_file)
print(os.path.exists(target_file))

target_dir = 'def'

print(os.path.exists(target_dir))
os.remove(target_dir)
print(os.path.exists(target_dir))

 

実行結果

True
False
True
Traceback (most recent call last):
  File "main.py", line 12, in 
    os.remove(target_dir)
IsADirectoryError: [Errno 21] Is a directory: 'def'

 

解説

os.path.existsでファイルやディレクトリが存在することを確かめました。os.removeでファイルabcを削除できました。

os.removeはディレクトリを削除できないので、ディレクトリdefの削除には失敗し、例外IsADirectoryErrorが発生しました。

 

サンプルコード shutil.rmtree

shutil.rmtreeで、ディレクトリdefの削除を試みます。

import os
import shutil

target_dir = 'def'

print(os.path.exists(target_dir))
shutil.rmtree(target_dir)
print(os.path.exists(target_dir))

 

実行結果

True
False

解説

os.path.existsでディレクトリが存在することを確かめました。shutil.rmtreeでディレクトリdefを削除できました。

 

監修してくれたメンター

橋本紘希

システムインテグレータ企業勤務のシステムエンジニア。

開発実績: Javaプログラムを用いた業務用Webアプリケーションや、基幹システム用バッチアプリケーションなどの設計構築試験。

 

大石ゆかり

内容分かりやすくて良かったです!

田島悠介

ゆかりちゃんも分からないことがあったら質問してね!

大石ゆかり

分かりました。ありがとうございます!

オンラインのプログラミングスクールTechAcademyではPythonを使って機械学習の基礎を学ぶPythonオンライン講座を開催しています。

初心者向けの書籍を使って人工知能(AI)や機械学習について学ぶことができます。

現役エンジニアがパーソナルメンターとして受講生に1人ずつつき、マンツーマンのメンタリングで学習をサポートし、最短4週間で習得することが可能です。

また、現役エンジニアから学べる無料のプログラミング体験会も実施しているので、ぜひ参加してみてください。