Java命名規則の標準まとめ｜クラス・変数・メソッドの書き方とマナーを解説

2026年3月6日

基本文法・構文

Javaを用いたシステム開発において、ソースコードの可読性や保守性を左右する最も基本的かつ重要な要素の一つが「命名規則」です。

多人数での共同作業が前提となるプロフェッショナルな現場では、自分だけが理解できるコードではなく、「誰が見ても意図が一目で伝わるコード」を書くことが強く求められます。

Javaには長年培われてきた標準的な規約が存在しており、これに従うことはエンジニアとしての最低限のマナーとも言えるでしょう。

本記事では、クラス、変数、メソッドといった各要素におけるJavaの標準的な命名ルールから、現場で役立つ実践的なテクニックまでを網羅的に詳しく解説します。

Java命名規則の重要性と基本概念

プログラミングにおける命名は、単に識別子を割り当てる作業ではありません。

適切に名付けられたコードは「自己説明的 (Self-describing) 」な性質を持ち、ドキュメントとしての役割も果たします。

なぜ命名規則が必要なのか

Javaは大規模なエンタープライズシステムの開発によく用いられる言語です。

数万、数十万行に及ぶソースコードの中で、命名規則がバラバラであれば、修正箇所の特定や機能の理解に膨大な時間がかかってしまいます。

命名規則を統一することで、チーム内でのコミュニケーションコストを最小限に抑え、バグの混入を防ぐことが可能になります。

また、Javaの標準ライブラリや有名なフレームワーク (Spring Frameworkなど) は、特定の命名規則に厳格に従って構築されています。

これらと同じルールを採用することで、ライブラリとの親和性が高まり、コード全体に一貫性が生まれるというメリットもあります。

代表的な表記法 (ケース)

Javaの命名規則を理解する上で、まずは「ケース (Case) 」と呼ばれる文字の綴り方のパターンを知っておく必要があります。

Javaでは主に以下の3つの表記法が使われます。

表記法	説明	例
アッパーキャメルケース (PascalCase)	各単語の先頭を大文字で始め、単語を繋げる。	`UserAccount`, `OrderService`
ローワーキャメルケース (camelCase)	最初の単語を小文字で始め、2つ目以降の単語の先頭を大文字にする。	`userName`, `calculateTotalAmount`
スネーミング・スネークケース (SCREAMING_SNAKE_CASE)	全て大文字で表記し、単語間をアンダースコア `_` で繋ぐ。	`MAX_RETRY_COUNT`, `DEFAULT_TIMEOUT`

Javaではスネークケース (all_lower_case) はパッケージ名を除いて基本的に使用しません。

特に変数名やメソッド名でアンダースコアを使用することは避け、キャメルケースを用いるのが一般的です。

パッケージの命名規則

パッケージは、クラスを論理的にグループ化するための仕組みです。

名前空間の衝突を避けるための重要な役割を担っています。

逆ドメイン形式の採用

パッケージ名は、組織のインターネットドメイン名を逆順にしたものを接頭辞として使用するのが標準です。

例えば、ドメインが example.com であれば、パッケージ名は com.example から始めます。

階層構造の設計

パッケージ名は全て小文字で記述します。

階層を深くしすぎるのは避けるべきですが、役割ごとに適切に分割することが推奨されます。

プロジェクト名を含む例： com.example.projectname.module
レイヤー別の例： com.example.app.controller, com.example.app.service, com.example.app.repository

パッケージ名にアンダースコアを使用することは技術的には可能ですが、Javaの慣習としては推奨されません。

単語を繋げる必要がある場合は、そのまま結合するか、さらにサブパッケージとして分割することを検討してください。

クラス・インターフェースの命名規則

クラスやインターフェースは、Javaプログラムの構成単位となる最も重要な要素です。

これらには「何であるか」を明確に示す名前を付ける必要があります。

クラス名の基本

クラス名には必ずアッパーキャメルケース (UpperCamelCase) を使用します。

また、名前は基本的に名詞であるべきです。

良い例： User, AccountManager, FileUploader
悪い例： ManageUser (動詞から始まっている), user_data (スネークケース)

抽象クラスの場合は、その性質を示すために Abstract という接頭辞を付けることが一般的です (例: AbstractService) 。

一方で、実装クラスに Impl という接尾辞を付ける慣習 (例: UserServiceImpl) も多くの現場で見られます。

インターフェース名の基本

インターフェースもクラスと同様にアッパーキャメルケースを使用します。

インターフェースの名前には、そのクラスが「何ができるか」を示す形容詞、あるいは抽象的な名詞が使われます。

形容詞の例： Runnable, Serializable, Comparable
名詞の例： List, UserRepository

以前はインターフェースに I という接頭辞を付ける (例: IUserService) 習慣もありましたが、現代のJava開発では推奨されません。

インターフェースは「型」そのものを表すため、実装を意識させない自然な名詞を選ぶのがベストです。

メソッドの命名規則

メソッドはオブジェクトの振る舞い (アクション) を表すため、命名には特定のパターンがあります。

動詞から始める

メソッド名にはローワーキャメルケース (lowerCamelCase) を使用し、原則として動詞から書き始めます。

取得： getUserName(), findOrderById()
設定・更新： setAddress(), updateProfile()
削除： deleteOldLogs(), removeTarget()
変換： toJson(), toString()

真偽値を返すメソッド

boolean 型を返すメソッドは、質問を投げかけるような形式にするのがマナーです。

接頭辞として is, has, can, should などを用います。

isEmpty()：空であるか
hasRole()：権限を持っているか
canExecute()：実行可能か
exists()：存在するか

よくある間違いとして、is と get を混同するケースがあります。

状態を確認するメソッドに getUserStatus() と名付け、戻り値が boolean であると、利用側は「Statusオブジェクト」が返ってくると誤解する可能性があります。

真偽値であれば isActive() など、状態そのものを問う名前にしましょう。

変数・定数の命名規則

変数名は、そのスコープや用途に応じて適切な長さを選択することが重要です。

ローカル変数とフィールド変数

どちらもローワーキャメルケースを使用します。

フィールド変数 (インスタンス変数) は、クラス内全体で使用されるため、多少長くなっても具体的で意味のある名前を付けるべきです。

一方、メソッド内のローカル変数は、その生存期間が短いため、文脈から意味が明らかな場合は簡潔な名前でも許容されることがあります。

ただし、a, b, temp といった意味を持たない名前は、ループカウンター (i, j) などの例外を除き、避けるのが賢明です。

定数の命名規則

static final で宣言される定数は、他の変数と明確に区別するためにスネーミング・スネークケース (SCREAMING_SNAKE_CASE) を使用します。

Java

public class AppConfig {
    // 定数は全て大文字でアンダースコア区切り
    public static final int MAX_CONNECTION_LIMIT = 100;
    public static final String DEFAULT_CHARSET = "UTF-8";
}

定数にこの表記法を使うことで、コードの途中で登場した際にも「これは書き換え不可能な固定値である」ということが瞬時に判断できます。

ジェネリクスの命名規則

Javaのジェネリクス (型引数) には、1文字の大文字を使用するという非常に強い慣習があります。

これは、通常のクラス名と混同しないようにするためです。

型引数	意味
`E`	Element (要素：集合の中で使われる)
`K`	Key (キー：Mapなどで使われる)
`V`	Value (値：Mapなどで使われる)
`T`	Type (型：汎用的な型)
`N`	Number (数値型)
`S`, `U`, `V`	2番目、3番目、4番目の型が必要な場合

避けるべき命名のアンチパターン

良質なコードを書くためには、「やってはいけない命名」を知ることも重要です。

1. 無意味な省略形の使用

usrAddr よりも userAddress、calcAmt よりも calculateAmount の方が圧倒的に読みやすいです。

現代のIDE (統合開発環境) には強力な補完機能があるため、タイピング数を減らすために名前を削る必要はありません。

「省略は混乱の元」だと心得ましょう。

2. 数値を含める

data1, data2 といった命名は、そのデータが何を表しているのか、1と2にどのような違いがあるのかを全く説明していません。

inputCustomerData, outputCustomerData のように、役割がわかる名前を付けてください。

3. 日本語やローマ字の使用

Javaは多国籍な開発者が関わる可能性があるため、識別子に日本語 (全角文字) を使うことは論外です。

また、ローマ字 (例: shohinName) も、日本人にしか伝わらないため、必ず英単語 (productName) を使用するようにしましょう。

実践的なコード例

ここまで解説した命名規則を統合したサンプルコードを示します。

各要素がどのように定義されているかを確認してください。

Java

package com.example.shop.service; // パッケージは逆ドメインの小文字

import java.util.ArrayList;
import java.util.List;

/**
 商品管理を行うサービスインターフェース
 */
interface ProductService {
    // メソッドは動詞から始まるキャメルケース
    void registerProduct(String productName, double price);
    boolean isAvailable(Long productId);
}

/**
 商品管理の実装クラス
 */
public class ProductManager implements ProductService {

    // 定数はスネーミング・スネークケース
    private static final int MAX_STORAGE_CAPACITY = 1000;

    // フィールド変数はローワーキャメルケース
    private List<String> productList = new ArrayList<>();

    @Override
    public void registerProduct(String productName, double price) {
        // ローカル変数もローワーキャメルケース
        String formattedName = productName.trim();
        
        if (productList.size() < MAX_STORAGE_CAPACITY) {
            productList.add(formattedName);
            System.out.println("Registered: " + formattedName + " at " + price);
        }
    }

    @Override
    public boolean isAvailable(Long productId) {
        // 真偽値を返すメソッドの例
        return productId != null && productId > 0;
    }

    public static void main(String[] args) {
        ProductManager manager = new ProductManager();
        manager.registerProduct("Laptop", 1500.0);
        
        // 実行結果の確認
        boolean result = manager.isAvailable(101L);
        System.out.println("Availability check: " + result);
    }
}

上記のプログラムを実行すると、以下の結果が得られます。

実行結果

Registered: Laptop at 1500.0
Availability check: true

命名規則を維持するためのツール

個人の意識に頼るだけでは、大規模なプロジェクトで命名規則を完全に統一するのは困難です。

そこで、静的解析ツールの活用を推奨します。

Checkstyle

Javaのコードが特定のコーディング規約に沿っているかを自動でチェックするツールです。

GoogleやSun (現Oracle) が定義した標準的な設定ファイルが提供されており、これを利用することで「クラス名がキャメルケースになっていない」といった違反をビルド時に検知し、エラーとして報告させることができます。

IDEのリンター

IntelliJ IDEAやEclipse、Visual Studio CodeなどのIDEには、リアルタイムで命名規則の違反を警告してくれる機能が備わっています。

例えば、フィールド変数を大文字で書き始めると、IDEが即座に波線で警告を表示します。

これを無視せず修正する習慣をつけることが、クリーンなコードへの第一歩です。

まとめ

Javaの命名規則は、単なる好みの問題ではなく、ソフトウェアの品質とチームの生産性を支える重要な基盤です。

パッケージ名: 逆ドメイン形式で全て小文字。
クラス・インターフェース名: アッパーキャメルケースの名詞。
メソッド名: ローワーキャメルケースで動詞から始める。
変数名: ローワーキャメルケースで具体的かつ簡潔に。
定数名: 全て大文字のスネークケース。
ジェネリクス: 大文字1文字 (T, E, K, Vなど)。

これらのマナーを厳守することで、あなたの書くコードは格段に読みやすくなり、他の開発者からの信頼も高まるでしょう。

常に「未来の自分や、名前も知らない同僚がこのコードを読む」という意識を持ち、一つ一つの名前にこだわってコーディングを進めていきましょう。