【C++】命名規則の決定版｜可読性を高める標準スタイルガイドとモダンなベストプラクティス

2026年2月6日

言語仕様・基本文法

C++を用いた開発において、プログラムの可読性と保守性を左右する最も重要な要素の一つが「命名規則」です。

C++は自由度が高い言語であるがゆえに、記述スタイルが開発者ごとに異なると、プロジェクトの規模が大きくなるにつれてコードの解読が困難になり、バグの温床となります。

本記事では、現代のC++開発において標準的とされるスタイルガイドから、モダンなベストプラクティスまでを網羅し、プロフェッショナルな現場で求められる命名の秘訣を詳しく解説します。

目次 [ close ]

なぜC++において命名規則が重要なのか

C++は、オブジェクト指向、ジェネリックプログラミング、メタプログラミングなど、多様なパラダイムをサポートしています。

そのため、一つの変数や関数が持つ役割が非常に多岐にわたります。

適切な命名規則を導入することで、コードを読んだ瞬間にその識別子が「クラスなのか」「変数なのか」「定数なのか」を判別できるようになり、レビューやメンテナンスのコストを大幅に削減できます。

また、C++の標準ライブラリ (STL) はすべて小文字のスネークケース (snake_case) で構成されていますが、アプリケーション層のコードではパスカルケース (PascalCase) やキャメルケース (camelCase) が好まれる傾向にあります。

これらの異なるスタイルをどのように調和させるかが、美しいコードを書くためのポイントとなります。

一般的な命名スタイルの種類

C++でよく使われる命名スタイルには、主に以下の4種類があります。

これらを要素の種類ごとに使い分けることが一般的です。

スタイル名	記述例	主な用途
スネークケース (snake_case)	`user_name`	変数名、関数名、標準ライブラリ互換の要素
パスカルケース (PascalCase)	`UserAccount`	クラス名、構造体名、列挙型名
キャメルケース (camelCase)	`calculateTotalScore`	関数名、メソッド名、ローカル変数名
スクリーミングスネークケース	`MAX_BUFFER_SIZE`	マクロ定数、一部の不変な定数

プロジェクトを開始する際には、これらのうちどれを採用するかをチーム内で統一することが不可欠です。

カテゴリ別の詳細な命名規則

ここでは、モダンなC++開発で広く採用されている具体的なルールをカテゴリ別に深掘りします。

クラスと構造体

クラス名や構造体名は、名詞または名詞句であるべきです。

型であることを明示するために、パスカルケース (PascalCase) を使用するのが一般的です。

C++

// 良い例：名詞で役割が明確
class UserProfile {
public:
    UserProfile(int id) : user_id_(id) {}
private:
    int user_id_;
};

// 構造体も同様にパスカルケースを使用することが多い
struct NetworkPacket {
    uint32_t header;
    std::vector<char> payload;
};

C++では、インターフェースを定義する場合に頭文字に I をつける習慣 (例: IRenderer) が一部にありますが、モダンなスタイルでは RendererInterface と末尾に付加するか、特につけずに純粋仮想関数を持つクラスとして定義することが推奨されます。

関数とメソッド

関数名は、その関数が「何をするか」を示す動詞で始めるべきです。

スタイルとしては、Googleのスタイルガイドのようにパスカルケースを採用する場合と、STLとの親和性を重視してスネークケースを採用する場合があります。

C++

// スネークケースによる関数定義 (STLスタイル)
void update_status(int new_status) {
    // 状態を更新する処理
}

// キャメルケースによるメソッド定義
class FileManager {
public:
    void openFile(const std::string& path) {
        // ファイルを開く処理
    }
};

ブール値を返す関数（述語関数）の場合は、is_active、has_permission、can_execute のように、疑問文の形式にすると条件分岐での可読性が向上します。

変数（ローカル・メンバ・グローバル）

変数の命名は、そのスコープによって区別をつけるのがC++の伝統的な作法です。

ローカル変数

ローカル変数は小文字で始め、スネークケースまたはキャメルケースを使用します。

短すぎず、かつ冗長になりすぎない名称が理想的です。

メンバ変数

クラスのメンバ変数（プライベート変数）は、ローカル変数や引数との衝突を避けるために、末尾にアンダースコアを付ける慣習が非常に強力です。

C++

class DatabaseConnector {
private:
    std::string connection_string_; // 末尾アンダースコアでメンバ変数を明示
    int retry_count_;

public:
    void set_retry_count(int retry_count) {
        retry_count_ = retry_count; // 引数との区別が容易
    }
};

以前は m_ というプリフィックス（接頭辞）を付ける手法も一般的でしたが、現代のモダンC++では末尾アンダースコアの方が視覚的なノイズが少ないとして好まれる傾向にあります。

グローバル変数

グローバル変数は可能な限り避けるべきですが、どうしても必要な場合は g_ というプリフィックスを付けることで、その変数が広範な影響を持つことを警告します。

定数と列挙型

定数は、その値がコンパイル時に決定されるのか、実行時に決定されるのかによって命名を分けることがあります。

constexpr 定数

constexpr や const で定義される定数は、通常の変数と区別するために k プリフィックスを用いたパスカルケース (例: kMaxRetryAttempts) が使われることがあります。

列挙型 (enum class)

モダンC++では、スコープを持つ enum class の使用が必須です。

列挙型名はクラスと同様にパスカルケース、列挙値もパスカルケースを使用するのが一般的です。

C++

enum class AppState {
    Starting,
    Running,
    Stopping,
    Terminated
};

// 使用時
AppState current_state = AppState::Running;

テンプレートと型パラメータ

テンプレートプログラミングにおいて、型パラメータには慣習的に T や U といった大文字1文字が使われます。

しかし、複数のテンプレート引数がある場合や、コンセプト (Concepts) を使用する場合は、より具体的な名称を付けることが推奨されます。

C++

// 1つだけの型パラメータなら T
template <typename T>
class Wrapper {};

// 意味を持つ場合は PascalCase
template <typename ElementType, typename AllocatorType>
class CustomContainer {};

モダンC++における「やってはいけない」命名

かつては推奨されていたものの、現代のC++開発ではアンチパターンとされる命名規則も存在します。

ハンガリアン記法: 変数名に型情報を付与する手法 (例: iCount, pPointer)。

IDEの進化により型情報は即座に確認できるため、現在ではコードの柔軟性を損なうだけの不要な装飾とみなされます。
二重アンダースコア: __variable や _Variable (大文字で始まるアンダースコア) は、C++の規格によってコンパイラや標準ライブラリの実装用に予約されています。

これらを使用すると、未定義動作の原因となる可能性があるため、ユーザーコードで使用してはいけません。
短すぎる変数名: ループカウンタとしての i, j を除き、1文字や2文字の変数名は避けるべきです。

命名規則を自動化・統一するツール

手動で命名規則を守り続けるのは困難です。

プロフェッショナルな現場では、以下のようなツールを使用して強制的にルールを適用します。

.clang-format

コードの整形を自動化するツールです。

命名規則そのものを変更する力は限定的ですが、インデントやスペース、改行の位置を統一することで、命名の不整合を視覚的に目立たせることができます。

clang-tidy

静的解析ツールである clang-tidy を使用すると、特定の命名規則に違反している場合に警告やエラーを出すことができます。

例えば、「メンバ変数は必ずアンダースコアで終わらなければならない」といったルールを .clang-tidy ファイルに定義可能です。

YAML

# .clang-tidy の設定例（一部）
CheckOptions:
  key:             readability-identifier-naming.MemberCase
    value:           lower_case
  key:             readability-identifier-naming.MemberSuffix
    value:           _
  key:             readability-identifier-naming.ClassCase
    value:           PascalCase

実践例：命名規則を適用したクラス設計

ここまでのルールを統合した、モダンなC++クラスの記述例を示します。

C++

#include <iostream>
#include <string>
#include <vector>

// 名前空間はすべて小文字のスネークケース
namespace app_utility {

/**
 @brief ユーザーの権限レベルを定義する列挙型
 */
enum class PermissionLevel {
    Guest,
    User,
    Administrator
};

/**
 @brief ユーザー情報を管理するクラス
 */
class UserAccount {
public:
    // コンストラクタの引数はスネークケース
    UserAccount(std::string account_name, PermissionLevel level)
        : account_name_(std::move(account_name)),
          permission_level_(level) {}

    // ゲッター関数（STLスタイル）
    const std::string& account_name() const { return account_name_; }
    
    // 述語関数
    bool is_administrator() const {
        return permission_level_ == PermissionLevel::Administrator;
    }

    // 処理を実行するメソッド（キャメルケースの例）
    void updateLastLoginTime() {
        // ログイン時刻を更新する処理
        std::cout << "Login time updated for: " << account_name_ << std::endl;
    }

private:
    // メンバ変数は末尾アンダースコア
    std::string account_name_;
    PermissionLevel permission_level_;
    
    // 定数は k プリフィックス
    static constexpr int kMaxLoginRetries = 3;
};

} // namespace app_utility

int main() {
    app_utility::UserAccount user("Alice", app_utility::PermissionLevel::Administrator);

    if (user.is_administrator()) {
        user.updateLastLoginTime();
    }

    return 0;
}

実行結果

Login time updated for: Alice

このコード例では、以下のルールが適用されています。

名前空間: app_utility (小文字スネーク)
クラス名: UserAccount (パスカルケース)
メンバ変数: account_name_ (スネークケース + 末尾アンダースコア)
定数: kMaxLoginRetries (kプリフィックス + パスカルケース)
関数名: 用途に応じてスネークケースとキャメルケースを使い分け

まとめ

C++における命名規則は、単なる好みの問題ではなく、ソフトウェアの品質を担保するための基盤です。

Google Style Guide や LLVM Coding Standards といった既存の標準をベースにしつつ、プロジェクトの性質に合わせて最適なルールを選択することが重要です。

重要なのは、一度決めたルールを絶対に崩さない一貫性です。

一貫した命名規則があるコードは、初めて読む開発者にとっても構造が予測しやすく、結果としてチーム全体の生産性を向上させます。

また、clang-tidy などのツールを活用して機械的にチェックする仕組みを導入することで、人間が本質的なロジックのレビューに集中できる環境を整えましょう。

モダンなC++の機能を最大限に活かしつつ、美しい命名規則によって「語るコード」を目指してください。