Pythonでファイルの存在を確認する方法【初心者向け】

初心者向けにPythonでファイルの存在を確認する方法について解説しています。外部から受け取ったファイルを処理する際、まず最初にそのファイルの存在を確認する必要があります。existsメソッド、isfileメソッド、isdirメソッドを使った確認方法をそれぞれの違いを見ながら学習していきましょう。

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

Pythonでファイルの存在を確認する方法について解説します。

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

 

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

 

田島悠介

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

大石ゆかり

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

田島悠介

ファイルの存在を確認する方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

ファイルの存在を確認する理由とは

プログラミングでは、外部のデータをテキストファイルで受け取ったり、写真を画像ファイルで受け取って処理する場合があります。例えば以下のような処理を考えてみましょう。

  1. プログラムと同じフォルダにある「test.txt」というファイルを開く
  2. ファイルの内容を読み込む
  3. 画面に表示する

この場合、1番目でファイルが存在していることを確認しないと、2番目以降の処理を正しく行うことができません。またプログラムからファイルにデータを書き込む際も、誤って同名のファイルを上書きしないよう、ファイルの存在を確認する必要があります。

このように、ファイルの存在を確認することは、プログラムでファイルを扱う上でとても重要です。

 

ファイルがあるか確認する書き方

Python では、標準の OS ライブラリを用いてファイルの存在を確認することができます。ファイルまたはフォルダの存在を確認するには exists メソッドを使用します。

os.path.exists(ファイルまたはフォルダのパス)

ファイルだけの存在を確認するには isfile メソッドを使用します。

os.path.isfile(ファイルのパス)

逆にフォルダ(ディレクトリ)だけの存在を確認するには isdir メソッドを使用します。

os.path.isdir(フォルダのパス)

 

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

実際に書いてみよう

今回のサンプルプログラムでは、exists 、 isfile 、 isdir メソッドを使い、 ファイルまたはフォルダの存在を確認する方法を紹介します。実行はPythonインタプリタで行います。コマンドラインで「python」と入力すると「>>>」と表示されますので、1行ずつプログラムを入力します。

また、プログラムを実行するフォルダに「hello.txt」というファイルと「Python」というフォルダがある状態とします。

はじめに必要なライブラリをインポートします。

import os

次にファイルの存在を確認してみましょう。

os.path.exists('hello.txt')

実行結果は以下のようになります。

True

同様にフォルダの存在を確認します。

os.path.exists('Python')

実行結果は以下のようになります。

True

次にファイルだけの存在を確認します。

os.path.isfile('hello.txt')

実行結果は以下のようになります。

True

最後にフォルダだけの存在を確認します。

こちらも実行結果は以下のようになります。

True

実際のプログラムでは以下のように使用します。

if(os.path.exists('hello.txt')):
    fileobj = open('hello.txt')
    data = fileobj.read()
    fileobj.close()
    print(data)

「hello.txt」ファイルが存在する場合、実行するとファイルの内容が表示されます。

こんにちは
Hello
你好

 

この記事を監修してくれた方

太田和樹(おおたかずき)
ITベンチャー企業のPM兼エンジニア

普段は主に、Web系アプリケーション開発のプロジェクトマネージャーとプログラミング講師を行っている。守備範囲はフロントエンド、モバイル、サーバサイド、データサイエンティストと幅広い。その幅広い知見を生かして、複数の領域を組み合わせた新しい提案をするのが得意。

開発実績:画像認識技術を活用した駐車場混雑状況把握(実証実験)、音声認識を活用したヘルプデスク支援システム、Pepperを遠隔操作するアプリの開発、大規模基幹系システムの開発・導入マネジメント

地方在住。仕事のほとんどをリモートオフィスで行う。通勤で消耗する代わりに趣味のDIYや家庭菜園、家族との時間を楽しんでいる。

 

大石ゆかり

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

田島悠介

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

大石ゆかり

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

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

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

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

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