C言語：fatal error: x.h: No such file or directory の原因と解決策

2026年5月28日

実践・応用

C言語の開発において、ヘッダーファイルの読み込みエラーは非常に頻繁に遭遇する問題の一つです。

コンパイルを実行した際に「fatal error: x.h: No such file or directory」というメッセージが表示されると、作業が中断されてしまいます。

このエラーは、プリプロセッサが指定されたヘッダーファイルを見つけられなかったことを意味しています。

一見すると単純なミスに見えますが、その原因はタイポから環境設定まで多岐にわたります。

本記事では、このエラーが発生する根本的な原因とその解決策について詳しく解説します。

目次 [ close ]

エラーメッセージが意味すること

「fatal error: x.h: No such file or directory」は、C言語のコンパイルプロセスにおける初期段階で発生します。

C言語のプログラムは、コンパイルの前に「プリプロセッサ」というプログラムによって処理されます。

プリプロセッサは、#includeディレクティブを見つけると、その場所に指定されたファイルの内容を挿入しようとします。

しかし、指定されたパスの中にファイルが存在しない場合、プリプロセッサは処理を続行できなくなります。

その結果、致命的なエラー（fatal error）として処理が停止します。

このエラーを解決するためには、コンパイラがどのディレクトリを探しているのかを理解することが重要です。

ヘッダーファイルの探索順序

コンパイラがヘッダーファイルを探す場所には、一定の優先順位が存在します。

一般的に、標準ライブラリのヘッダーはシステムが定義した特定のディレクトリから探されます。

一方で、開発者が作成した独自のヘッダーファイルは、現在の作業ディレクトリを基準に探されることが一般的です。

この探索ルールを誤解していると、ファイルが存在しているにもかかわらずエラーが解消されない事態に陥ります。

エラーが発生する主な原因

このエラーが発生する背景には、いくつかの典型的なパターンが存在します。

まずは、自分のプログラムがどのケースに当てはまるのかを確認してみましょう。

1. ファイル名のタイポや拡張子のミス

最も基本的な原因は、#includeに記述したファイル名のスペルミスです。

大文字と小文字が区別される環境（Linuxなど）では、stdio.hとStdio.hは別物として扱われます。

また、拡張子が.hではなく.hppや.incになっている場合も、正しく指定しなければなりません。

2. 不適切なインクルード記法

C言語では、ヘッダーファイルを指定する際に「< >」と「” “」の2種類の記号を使い分けます。

#include <x.h>は、主にシステムの標準ディレクトリからファイルを探します。

#include "x.h"は、最初にソースファイルと同じディレクトリを探し、見つからない場合にシステムディレクトリを探します。

自作のヘッダーファイルを「< >」で囲んでしまうと、コンパイラが見つけられないことがあります。

3. インクルードパスが設定されていない

ソースファイルとは別のディレクトリにヘッダーファイルを配置している場合、コンパイラにその場所を教える必要があります。

デフォルトの状態では、コンパイラは特定の標準パスとカレントディレクトリしか参照しません。

外部ライブラリをインストールした直後などに、この設定漏れが多く見られます。

具体的な解決策と対処法

エラーの原因を特定できたら、次は適切な対処を行いましょう。

以下に、開発現場でよく用いられる解決方法をまとめました。

コンパイラオプションでパスを指定する

GCCやClangを使用している場合、-Iオプション（アイ・大文字）を使用してヘッダーの検索パスを追加できます。

例えば、includeディレクトリの中にヘッダーファイルがある場合は、以下のようにコマンドを入力します。

Shell

gcc -I./include main.c -o myprogram

このオプションを使用することで、コンパイラは指定したディレクトリ内を優先的に探索するようになります。

複数のディレクトリを指定したい場合は、-Iオプションを複数回記述することが可能です。

開発環境（IDE）の設定を確認する

VS CodeやVisual StudioなどのIDEを使用している場合、エディタ上の赤い波線とコンパイルエラーは別物です。

VS Codeの場合は、c_cpp_properties.jsonという設定ファイルのincludePath項目を編集する必要があります。

以下の例は、プロジェクト内のincludeフォルダを認識させるための設定例です。

JSON

{
    "configurations": [
        {
            "name": "Win32",
            "includePath": [
                "${workspaceFolder}/**",
                "${workspaceFolder}/include"
            ],
            "defines": [],
            "compilerPath": "C:/MinGW/bin/gcc.exe",
            "cStandard": "c11",
            "cppStandard": "c++17",
            "intelliSenseMode": "windows-gcc-x64"
        }
    ],
    "version": 4
}

設定ファイルを正しく記述することで、IDEのインテリセンス機能が正常に働き、定義へのジャンプも可能になります。

ライブラリのインストール状況を確認する

特定の外部ライブラリ（例：OpenSSLやzlibなど）を使用している場合、開発用パッケージが未インストールな可能性があります。

Linux環境（Ubuntuなど）では、実行用のライブラリとは別に、ヘッダーファイルを含む「-dev」パッケージが必要です。

Shell

# 例：SSL関連のエラーが出る場合
sudo apt install libssl-dev

パッケージをインストールした後は、ヘッダーファイルが/usr/includeなどの標準パスに配置されるため、エラーが解消されます。

トラブルシューティング・チェックリスト

解決しない場合は、以下の表を参考にして現在の状況を整理してください。

確認項目	チェック内容	対応策
スペルチェック	ファイル名に間違いはないか	一文字ずつ再確認する
引用符の種類	“” と <> を正しく使い分けているか	自作ヘッダーなら “” を使う
ファイルの実在	そのパスに本当にファイルがあるか	`ls`コマンド等で確認する
コンパイラ引数	-I オプションを指定したか	ビルドコマンドを見直す
環境変数	C_INCLUDE_PATHが正しいか	環境変数の設定値を表示する

実際のコード例を用いた解説

実際にエラーが発生する状況と、それを解決するコードの構成を見てみましょう。

以下のようなディレクトリ構造を想定します。

text

project/
├── src/
│   └── main.c
└── include/
    └── mymath.h

この時、main.cからmymath.hを読み込む際の間違った例と正しい例を比較します。

失敗するケース

C言語

/* main.c */
#include <mymath.h> // システムディレクトリにないためエラー

int main() {
    return 0;
}

実行結果

fatal error: mymath.h: No such file or directory
compilation terminated.

成功するケース

C言語

/* main.c */
// 相対パスで指定するか、コンパイラオプションを使用する
#include "mymath.h" 

int main() {
    // 処理内容
    return 0;
}

コンパイル時には、以下のようにパスを指定して実行します。

Shell

gcc -I../include src/main.c -o myprogram

このように、「ソースコード内の記述」と「コンパイル時の設定」の両面からアプローチすることが重要です。

ビルドシステムを活用した管理

プロジェクトの規模が大きくなると、手動でパスを指定するのは困難になります。

そのため、現代の開発ではCMakeやMakeなどのビルドツールを使用するのが一般的です。

CMakeを使用する場合、target_include_directoriesというコマンドでパスを管理します。

CMake

# CMakeLists.txt の例
cmake_minimum_required(VERSION 3.10)
project(MyProject)

add_executable(myprogram src/main.c)

# includeディレクトリをインクルードパスに追加
target_include_directories(myprogram PUBLIC include)

ビルドシステムを介することで、プロジェクト内のどこからでもヘッダーファイルを正しく参照できるようになります。

また、共同開発を行う際にも、個々の環境に依存しないビルド環境を構築することが可能になります。

まとめ

C言語における「fatal error: x.h: No such file or directory」は、決して解決が難しいエラーではありません。

まずは、ファイル名が正しいか、そして#includeの記述方法が適切かを確認してください。

次に、コンパイラが探索するパスにファイルが含まれているかをチェックし、必要に応じて-Iオプションを活用しましょう。

IDEを使用している場合は、その設定ファイルが現在のディレクトリ構造と一致しているかを再点検することが大切です。

これらの基本的なステップを一つずつ踏むことで、必ずエラーを解消し、スムーズに開発を進めることができるようになります。

ヘッダーファイルの管理はプログラムの構成を支える重要な要素ですので、この機会にマスターしておきましょう。