No uch file or directoryエラーの原因と解決法【Python/Linux/Ubuntu】

プログラミングをしていると、突然「No such file or directory」というエラーメッセージに遭遇することがあります。このエラーは、指定したファイルやディレクトリが見つからないときに発生し、初学者からベテランまで誰もが一度は経験するものです。この記事では、エラーの意味から環境別の具体的な対処法までをわかりやすく解説します。

エラーメッセージの意味: ファイルまたはディレクトリが存在しない ·
エラーコード: ENOENT (errno 2) ·
主な原因: ファイルパスの誤り、タイプミス、権限不足、シンボリックリンクの切れ ·
発生頻度の高い環境: Python, Linux, Ubuntu, C++, Blender, シェルスクリプト

1. カレントディレクトリを確認する
2. ファイル名と拡張子を再確認する
3. 絶対パスを試す
4. 権限を確認する
5. シンボリックリンクのリンク先をチェックする

以下の表にエラーの基本データをまとめました。

「No such file or directory」エラーの意味とは？

エラーメッセージの直訳とENOENT

• 直訳は「そのようなファイルまたはディレクトリはありません」
• ENOENTは「Error NO ENTry」の略（mebeeのエラーコード解説）
• システムコールが対象リソースを見つけられなかったことを示す

このエラーは、ファイルシステム上のパスが不正な場合にカーネルから返される最も基本的なエラーのひとつです。PythonやC、シェルスクリプトなど、どの言語でも同じシステムエラーが発生します。

エラー番号2の解説

• errnoリストで2番目に定義されている
• Linuxの/usr/include/asm-generic/errno-base.hで#define ENOENT 2と宣言
• 「No such file or directory」を表す標準エラーコード

エラー番号2はPOSIX規格で定められており、Unix系OSであればどこでも同じ意味を持ちます。このコードを見たら「ファイルが見つからない」と即座に判断できます。

どのような状況で表示されるか

• open()で存在しないファイルを指定
• cdで存在しないディレクトリに移動しようとした
• 実行ファイルのパスが間違っている
• シンボリックリンクが切れている（mebeeのトラブル例）

これらの状況は共通して「OSが指定されたパスを解決できなかった」という点で一致します。エラーの発生パターンを理解すれば、原因を絞り込むのが早くなります。

Pythonで「No such file or directory」エラーを解決する方法

open()関数でのパス指定の注意点

• open()に渡すパスは実行環境のカレントディレクトリ基準（PyQブログの指摘）
• 存在確認せずに書き込みモードで開こうとするとエラー
• テキストファイルとバイナリファイルの区別はパスに影響しない

Pythonのopen()関数は、第一引数に指定されたパスをそのままシステムに渡します。相対パスの場合、カレントディレクトリからの相対位置が使われるため、実行ディレクトリを意識しないと思わぬエラーになります。

カレントディレクトリの確認

• os.getcwd()で現在の作業ディレクトリを取得
• コマンドラインで実行する場合、cdで該当ディレクトリに移動してからpythonを実行（teratailのQA事例）
• IDE内で実行するとプロジェクトルートがカレントディレクトリになることも

カレントディレクトリの確認は最もシンプルで効果的なトラブルシューティングです。思わぬ場所で実行しているケースが非常に多いからです。

os.path.exists()で事前確認

• os.path.exists(path)でファイルやディレクトリの存在を確認可能
• os.path.isfile() / os.path.isdir()で種別も判定
• 存在しない場合に適切なエラーハンドリングができる

事前確認を入れることで、エラー発生の有無をプログラム側で判定し、ユーザーにわかりやすいメッセージを表示できます。

相対パスと絶対パスの使い分け

• 相対パスはカレントディレクトリに依存（CodeCamp Trendsの解説）
• 絶対パスは環境が変わっても同じ場所を指す
• os.path.abspath()で相対パスを絶対パスに変換できる

プログラムの移植性を考えると絶対パスのハードコーディングは避けたいところですが、スクリプトの先頭でカレントディレクトリを固定する方法も有効です。

Linux/Ubuntuで「No such file or directory」エラーを修正する方法

cdコマンドでエラーが出る原因と対策

• 指定したディレクトリが存在しない場合に発生（愛媛大学のFAQ）
• 大文字小文字の違いにも注意（Linuxは区別する）
• cd path/to/dir の前に ls で存在を確認する習慣を

cdコマンドが失敗する原因の大半は、単純なタイプミスかディレクトリ名の勘違いです。lsで候補を表示してからコピー・アンド・ペーストするのも確実な方法です。

ファイルの存在確認（ls, testコマンド）

• ls -l ファイル名 で存在と権限を一括確認
• test -e ファイル名 で真偽値を返す（シェルスクリプトで便利）
• stat ファイル名 で詳細なファイル情報を取得

これらのコマンドを覚えておけば、エラー原因が「存在しない」のか「権限がない」のかを切り分けられます。

パーミッションと所有権の確認（ls -l, chmod, chown）

• 権限不足でも「No such file or directory」と表示される場合がある（mebeeの事例）
• ls -lでパーミッションと所有者を確認
• chmodで読み取り権限を追加、chownで所有者を変更

権限の問題は「Permission denied」とは別のエラーメッセージになることもあるため、パーミッションを確認する習慣がトラブル回避につながります。

シンボリックリンクのリンク切れチェック

• readlink -f リンク名 でリンク先を辿る（mebeeのトラブルシューティング）
• リンク切れがあると「No such file or directory」になる
• find . -xtype l で切れたシンボリックリンクを検索

システム管理をしていると、シンボリックリンクが切れているのに気づかないまま運用してしまうケースがあります。定期的なチェックを推奨します。

ターミナルで「No such file or directory」エラーが表示されたときの一般的なチェックポイント

ファイル名のタイプミス

• 最も多い原因。Tabキーで補完する習慣を（utataneblog760の解説）
• 見た目が似た文字（1とl、0とO）に注意
• 拡張子の有無やアンダースコアの位置も確認

タイプミスは人間誰でも起こします。コマンドラインではTab補完を積極的に使いましょう。

隠しファイル（.で始まるファイル）

• ls -aで隠しファイルを含めて表示
• .で始まるファイルは明示的に指定しないと見えない
• 隠しファイルを指定するときは先頭の.を含める

設定ファイルなどが隠しファイルとして配置されているのに、それを忘れてエラーになるケースがあります。

スペースを含むパスの扱い

• スペースを含むパスは引用符で囲むかバックスラッシュでエスケープ
• 例: /home/user/My\ Documents/file.txt
• 変数に格納するときも引用符で保護する

スペースを含むディレクトリ名はWindowsだけでなくLinuxでも存在します。パス全体をダブルクォートで囲むのが安全です。

環境変数PATHの設定ミス

• PATHに含まれていないディレクトリのコマンドは実行できない
• echo $PATH で現在のPATHを確認
• export PATH=$PATH:/新規パス で追加可能

自作スクリプトやインストールしたツールが「No such file or directory」で動かない場合、PATH設定を見直しましょう。

BlenderやC++など特定環境での「No such file or directory」エラー対処法

Blenderのファイルパス設定

• Blenderのファイルブラウザに依存するパスが原因になる
• アドオンやスクリプトで外部ファイルを読み込む場合は絶対パスを推奨
• BlenderのPythonコンソールでos.getcwd()を確認

Blender内蔵のPythonはカレントディレクトリが実行環境と異なる場合があるため、相対パスが期待通りに動作しないことがあります。

C++の#includeパスの指定

• #include は標準インクルードパスを検索
• #include “file” はカレントディレクトリを検索
• -Iオプションで追加のインクルードパスを指定（愛媛大学のC言語FAQ）

C++ではヘッダファイルが見つからないとコンパイルエラーになります。インクルードパスを正しく設定することが重要です。

Dockerコンテナ内のファイルマウント

• docker run -v ホストパス:コンテナパス でファイルをマウント
• マウントされていないホストファイルはコンテナから見えない
• Dockerバージョンによりマウントの挙動に差異がある可能性

Docker環境では、ホストとコンテナのパスが独立していることを常に意識する必要があります。コンテナ内でエラーが出たら、マウント設定を見直しましょう。

シェルスクリプトのシバン行と改行コード

• シバン（#!/bin/bash）が間違っているとインタプリタが見つからない
• Windowsで編集したスクリプトの改行コードCRLFが原因でエラーになる（utataneblog760の指摘）
• dos2unixコマンドで改行コードを変換可能

シェルスクリプトの改行コード問題は、クロスプラットフォーム開発でよく発生します。スクリプトの先頭行が表示されるエラーとして現れることが多いです。

確認済みの事実とまだ不明な点

「gccを実行しているディレクトリが正しいか確認してください」

— 愛媛大学情報サービスセンター（大学公式FAQ）

「指定したファイルが見つからない場合、パスの確認とファイル名の綴り確認が最初の対処として案内されています」

— PyQブログ（Python学習サイト）

このエラーに遭遇したら、まずカレントディレクトリを確認し、ファイル名の綴りと拡張子を再チェックする——この基本手順を守るだけで大半のケースは解決します。環境ごとの特有の原因にまで踏み込めるようになれば、エラーに振り回されることはなくなります。Pythonユーザーにとっては、絶対パスの活用と事前存在確認の習慣化が、長期的に最も確実な予防策です。

よくある質問

以上がよくある質問への回答です。これらのポイントを押さえておけば、エラー解決の手助けになるでしょう。

関連記事

• 「No such file or directory」エラー完全対策ガイド：環境別の原因とトラブル解決法
• No such file or directory エラー：意味、原因、環境別の完全解決ガイド

これらの関連記事も参照して、理解を深めてください。