Google の Java コーディング仕様

Googleは最近、完全なJavaコーディング仕様をリリースしました。仕様の内容には、いくつかの実践的かつ厳格な規定が含まれています。 Google は内部的にこの仕様を遵守しています。この仕様は、コード形式だけでなく、他の種類の規約やコーディング標準もカバーしています。

この仕様は主に、基本的なソースファイル仕様、ソースファイル構造、コード形式、命名、プログラミング実践、Javadocの6つの部分に分かれています。ソースファイルの基本仕様には、ファイル名、ファイルエンコーディング、スペース、特殊文字などの仕様要件が記述されています。ソース ファイルの構造には、ライセンス情報、パッケージとインポートの宣言、クラス メンバーの順序、その他の規範的な要件が記述されています。コード形式は、ソース コードの中括弧、インデント、改行、スペース、括弧、列挙、配列、switch ステートメント、注釈、注釈、修飾子などの書式設定要件を記述するために使用されます。命名では、識別子 (パッケージ、クラス、メソッド、定数、プロパティ、ローカル変数、およびクラス変数) の命名規則とキャメルケース定義を指定します。プログラミングの実践では、@Override、例外、静的メンバー、およびファイナライザーの使用法を示します。 Javadoc では、Javadoc が必要な場所とその形式要件について説明します。

以下は仕様からの抜粋です:

インポートではワイルドカード文字を使用できません。

オーバーロードされたメソッドは一緒に配置し、連続して表示する必要があります。

コード ブロックにコンテンツがない場合、またはコードが 1 行しかない場合でも、中括弧を使用する必要があります。

2スペースインデント。

列幅は80文字または100文字です。

C言語のような配列変数宣言は使用できません。

switch ステートメントには、default ステートメントが含まれている必要があります。

修飾子の順序は、Java 言語仕様で推奨されている順序である必要があります。

定数の名前付けには、CONSTANT_CASE 形式を使用する必要があります (注釈: すべての文字は大文字で、単語はアンダースコアで区切られます)。すべての定数は静的最終メンバーである必要がありますが、すべての静的最終メンバーが定数であるわけではないことに注意してください。

詳しくは、Google Java Styleをご覧ください。オラクルは、公式の Java 言語コーディング仕様も提供しています。 Google は、C++、Objective-C、Python、Shell、HTML/CSS、JavaScript、Lisp など、他の言語のコーディング スタイル ガイドも提供しています。

元の英語リンク: Google の Java コーディング標準