【Python】ファイルがあるのに「no such file or directory」エラーになる原因

Pythonでファイルを操作するとき、実際はファイルがあるのに「no such file or directory」というエラーが出る場合があります。「相対パスの使い方」や「現在の作業ディレクトリとファイルの配置が合っていない」などが原因である可能性が高く、ファイルパスの処理を理解していないとファイルが正しく存在していてもエラーが発生しやすくなります。

【サンプルコード】
# 存在するファイルにアクセスしようとしてエラーが出る例
import os

# 現在の作業ディレクトリを確認
current_dir = os.getcwd()
print(f"現在の作業ディレクトリ: {current_dir}")

# 存在するはずのファイルを開く
try:
    with open("data/sample.txt", "r") as file:
        content = file.read()
        print(content)
except FileNotFoundError as e:
    print(f"エラー: {e}")

【実行結果】
現在の作業ディレクトリ: /home/user/projects
エラー: [Errno 2] No such file or directory: 'data/sample.txt'

上記のサンプルコードでエラーが出るのは、相対パス「data/sample.txt」が現在の作業ディレクトリを基準にしているためです。実際にはファイルがあるのに、Pythonの実行場所とファイルの位置関係が合っていないと同様のエラーが出ます。os.path.exists()であらかじめファイルが本当に存在するか確認すると、パス指定ミスを素早く見つけられます。

「Python」を学べるコードキャンプのサービス

• 「Python」を学べる
  中高生向けサービス

  

• 「Python」を学べる
  企業研修サービス

  

ファイルパスの指定を誤ると、どこからスクリプトを実行しても「no such file or directory」エラーが出やすくなります。絶対パスは作業ディレクトリに依存せずファイルを参照できる利点がある一方、相対パスはスクリプトの場所を基準としたパスにする方法が便利です。

【サンプルコード】
import os

# 絶対パスの利用
file_absolute_path = "/home/user/projects/data/sample.txt"
try:
    with open(file_absolute_path, "r") as file:
        content = file.read()
        print(f"絶対パス読み込み成功: {content[:20]}...")
except FileNotFoundError as e:
    print(f"絶対パスエラー: {e}")

# スクリプトのディレクトリを基準にした相対パスの利用
script_dir = os.path.dirname(os.path.abspath(__file__))
file_relative_path = os.path.join(script_dir, "data", "sample.txt")
try:
    with open(file_relative_path, "r") as file:
        content = file.read()
        print(f"相対パス読み込み成功: {content[:20]}...")
except FileNotFoundError as e:
    print(f"相対パスエラー: {e}")

【実行結果】
絶対パス読み込み成功: これはサンプルテキストファ...
相対パス読み込み成功: これはサンプルテキストファ...

絶対パスでは環境を問わず、同じ場所のファイルを指定できるため、確実にエラーを防ぎやすいです。ただし、ファイルパスが固定化されるので、本番環境と開発環境で構成が変わる場合は要注意です。相対パスを使うときは、os.path.dirname(os.path.abspath(__file__))を基準にして、os.path.join()でパスを組み立てると可搬性が高いコードになります。

ファイルがあるのに「no such file or directory」エラーが出るときは、パスの確認やデバッグが重要です。作業ディレクトリやスクリプトの配置を確認しながら、実際のディレクトリ構造とコードのパス指定が合っているかを検証します。

【サンプルコード】
import os
import sys

def debug_path_info(filepath):
    print(f"対象ファイルパス: {filepath}")
    print(f"現在の作業ディレクトリ: {os.getcwd()}")
    print(f"スクリプトの場所: {os.path.dirname(os.path.abspath(__file__))}")
    print(f"ファイルは存在するか: {os.path.exists(filepath)}")
    
    abs_path = os.path.abspath(filepath)
    print(f"絶対パスに変換: {abs_path}")
    print(f"絶対パスは存在するか: {os.path.exists(abs_path)}")
    
    parent_dir = os.path.dirname(abs_path)
    print(f"親ディレクトリ: {parent_dir}")
    print(f"親ディレクトリは存在するか: {os.path.exists(parent_dir)}")
    
    if os.path.exists(parent_dir):
        print(f"親ディレクトリの内容: {os.listdir(parent_dir)}")

problem_filepath = "data/sample.txt"
debug_path_info(problem_filepath)

【実行結果】
対象ファイルパス: data/sample.txt
現在の作業ディレクトリ: /home/user/projects
スクリプトの場所: /home/user/projects/scripts
ファイルは存在するか: False
絶対パスに変換: /home/user/projects/data/sample.txt
絶対パスは存在するか: False
親ディレクトリ: /home/user/projects/data
親ディレクトリは存在するか: True
親ディレクトリの内容: ['config.json', 'example.txt', 'samples']

上記のようにデバッグ情報を出力すれば、どのディレクトリを基準にしてファイルを探しているかを明確にできます。サンプルコードでは「dataディレクトリ」に本来のファイルがなく、「data/samples」ディレクトリに配置されている可能性がうかがえます。パスを統一して管理するには、pathlibモジュールを利用する方法なども有効です。

※上記コンテンツの内容やソースコードはAIで確認・デバッグしておりますが、間違いやエラー、脆弱性などがある場合は、コメントよりご報告いただけますと幸いです。

ITやプログラミングに関するコラム

• 
  【Python】アプリ開発の練習方法｜初心者向け
• 
  【Python】エクセルの作業を自動化する例を紹介
• 
  Pythonで何ができる？趣味にも活用する方法などを解説
• 
  【Excel】半角を全角、全角を半角に変換する方法

ITやプログラミングに関するニュース

• 
  Google「Gemini 2.0 Flash」で画像生成と編集機能を追加！AIで画像編集がさらに自由に
• 
  汎用AIエージェント「Manus」登場！あなたの代わりに成果を出す新世代AIエージェント
• 
  Appleが新型iPad AirとMagic Keyboardを発表
• 
  AnthropicがClaude 3.7 Sonnetを発表！初のハイブリッド推論AIと拡張思考モードを搭載
• 
  AppleがiPhone 16e発表！A18チップとApple Intelligence搭載