C++ヘッダファイルのお作法： #pragma once 対インクルードガード

2025年8月28日

C++で複数のファイルに分割して開発を進めていると、同じヘッダファイルを意図せず複数回インクルードしてしまい、「クラスが再定義されています」といったコンパイルエラーに遭遇することがあります。これはC++の**ODR（One Definition Rule – ワン・デフィニション・ルール）**違反が原因で起こります。

この問題を解決するための、代表的な2つの手法「インクルードガード」と「#pragma once」について、それぞれの特徴と使い分けを解説します。

伝統的な解決策：「インクルードガード」

インクルードガードは、プリプロセッサディレクティブ (#ifndef, #define, #endif) を使って、特定のヘッダファイルの内容が一度しか処理されないようにする、C++標準に準拠した伝統的な手法です。

インクルードガードの仕組み

// UserProfile.h

#ifndef USER_PROFILE_H_INCLUDED
#define USER_PROFILE_H_INCLUDED

#include <string>

class UserProfile {
private:
    int userID;
    std::string userName;
public:
    // ...
};

#endif // USER_PROFILE_H_INCLUDED

この仕組みは以下の通りです。

初回のインクルード: コンパイラがこのファイルを初めて読み込むとき、USER_PROFILE_H_INCLUDED というマクロはまだ定義されていません (#ifndef)。そのため、#define から #endif までのコードがすべて処理され、その過程で USER_PROFILE_H_INCLUDED が定義されます。
2回目以降のインクルード: 再びこのファイルがインクルードされると、USER_PROFILE_H_INCLUDED は既に定義済みです。そのため、#ifndef の条件が偽となり、#endif までのコードブロック全体がスキップされます。

メリット: C++の標準機能なので、どのような古いコンパイラや特殊な環境でも100%動作する高い移植性があります。
デメリット: 記述が冗長（最低3行必要）。マクロ名が他のファイルと衝突しないようにユニークな名前を考える必要があり、タイポ（打ち間違い）のリスクもあります。

より現代的な解決策：「`#pragma once`」

#pragma once は、インクルードガードと同じ目的を、よりシンプルに達成するためのディレクティブです。ヘッダファイルの先頭にこの1行を記述するだけで、コンパイラはそのファイルが複数回インクルードされるのを防いでくれます。

`#pragma once` の使い方

// UserProfile.h

#pragma once

#include <string>

class UserProfile {
private:
    int userID;
    std::string userName;
public:
    // ...
};

見ての通り、非常に簡潔です。

メリット: コードが簡潔になり、マクロ名の衝突やタイポの心配がありません。コンパイラによっては、ファイルのパスでインクルード済みかを判断するため、インクルードガードよりもコンパイルが若干速くなる場合があります。
デメリット: C++の標準機能ではありません。ただし、MSVC, GCC, Clang をはじめとする現在主流のほぼ全てのコンパイラでサポートされているため、実用上の問題になることは稀です。

`#pragma once` vs インクルードガード：どちらを使うべき？

両者の特徴を比較してみましょう。

項目	インクルードガード (`#ifndef`)	`#pragma once`
簡潔さ	△ (3行必要で冗長)	◎ (1行で済む)
エラー耐性	△ (マクロ名の衝突・タイポの可能性)	◎ (ミスが起きにくい)
移植性	◎ (C++標準で100%保証)	◯ (非標準だが、事実上の標準)
コンパイル速度	◯	◎ (高速な場合がある)

Google スプレッドシートにエクスポート

結論

新規のモダンなプロジェクト: #pragma once を推奨します。 記述がシンプルでミスが少なく、主要なコンパイラで完全にサポートされているため、実用上のデメリットはほぼありません。
非常に高い移植性が求められるライブラリ: どのような環境でもビルドできることを保証する必要がある場合は、標準に準拠したインクルードガードを使用するのが最も安全です。

中には、両方を併記して最大限の安全性を確保するスタイルもありますが、現代の一般的な開発においては #pragma once だけで十分と言えるでしょう。