Pythonにおけるno such file or directoryエラーの回避方法を現役エンジニアが解説【初心者向け】

初心者向けにPythonにおけるno such file or directoryエラーの回避方法について現役エンジニアが解説しています。FileNotFoundErrorは、存在しないファイルやディレクトリにアクセスしようとした際に発生する例外です。ディレクトリの移動の際にも発生します。

TechAcademyマガジンは受講者数No.1のオンラインプログラミングスクールTechAcademy [テックアカデミー]が運営。初心者向けに解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。

Pythonにおけるno such file or directoryエラーの回避方法について、テックアカデミーのメンター(現役エンジニア)が実際のコードを使用して、初心者向けに解説します。

 

目次

Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。

 

田島悠介

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

大石ゆかり

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

田島悠介

Pythonにおけるno such file or directoryエラーの回避方法について詳しく説明していくね!

大石ゆかり

お願いします!

 

no such file or directoryエラーとは?

FileNotFoundError (エラーメッセージはno such file or directory) は、存在しないファイルやディレクトリにアクセスしようとした際に発生するエラーです。

 

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

no such file or directoryエラーが発生する原因

例1 存在しないファイルを開こうとした場合

open('tmp.txt')

ファイルtmp.txtが存在しない状態でコードを実行すると、以下のエラーが発生します。

FileNotFoundError: [Errno 2] No such file or directory: 'tmp.txt'

エラーメッセージの通り、tmp.txtファイルが存在しないため、例外になります。

例2 存在しないディレクトリに移動しようとした場合

import os
os.chdir('tmp')

os.chdirは指定のディレクトリに移動するメソッドです。
ディレクトリtmpが存在しない状態で上記のコードを実行すると、以下の例外が発生します。

FileNotFoundError: [Errno 2] No such file or directory: 'tmp'

エラーメッセージの通り、tmpディレクトリが存在しないため、例外になります。

 

例3 Pythonを実行するディレクトリとファイルやフォルダのディレクトリが異なる場合

ファイルは確かに存在するのに、FileNotFoundErrorが出る場合は、Pythonを実行しているディレクトリから、ファイルやフォルダが参照できていないケースが考えられます。

例えば、下記のディレクトリの構造において、test.py からopen(sample.txt) を実行するとエラーが起こります。

この場合、test.py からは同じディレクトリに存在するsameDir.txt は参照できますが、sample.txt は参照できません。

なので、sample.txt を開こうとするとエラーが起こってしまいます。

エラーを避けるためには、ファイルを開くときに open (./sampleDir/sample.txt) とするか、絶対パスを使いましょう。

(絶対パス、相対パスの使い方に関する説明はこちらをご参考ください。)

 

no such file or directoryエラーを発生させないために正しい記述を理解する

上記の例で見たように、アクセスしようとするファイルやディレクトリが存在しないことが原因です。

解決するには、下記の点をまず確認してみましょう。

  • ファイルやディレクトリの名前が正確か
  • 実行しているディレクトリからファイルやフォルダの場所 (パス) は正しく指定されているか

例外の発生がやむをえない場合には、try-except構文を用いてFileNotFoundErrorを捕捉し、適宜エラー処理します。

 

執筆してくれたメンター

橋本紘希(はしもとひろき)

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

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

 

大石ゆかり

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

田島悠介

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

大石ゆかり

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

 

Pythonを学習中の方へ

これで解説は終了です、お疲れさまでした。

  • つまずかず「効率的に」学びたい
  • 副業や転職後の「現場で使える」知識やスキルを身につけたい

プログラミングを学習していて、このように思ったことはありませんか?

テックアカデミーのPythonコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。

合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、人工知能(AI)や機械学習の基礎を完全オンラインでしっかり習得できます。

まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。

時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします!