インデントをつける

プログラムコードを書く時にインデントをつけることをオススメします。

インデントをつけることで、プログラムを作った人以外がみてもプログラムが読みやすくなります。

インデントについては、プログラム言語・プロジェクトにより規定がありますのでプログラミングをする前に確認が必要です。

よく使われるインデントは「タブ」「半角スペース４つ」「半角スペース２つ」が使われます。

インデントがない場合の例

int point = 10;
if(point >= 70){
System.out.print("pointは70以上です。");
}else{
System.out.print("pointは70未満です。");
}

インデントをつけた例

int point = 10;
if(point >= 70){
    System.out.print("pointは70以上です。");
}else{
    System.out.print("pointは70未満です。");
}

比較文は少なくする

比較文は可能な限り少なくコーディングすることをオススメします。

通常通り比較文をコーディングした例

if (70 <= sum) {
  passFg = 1;
} else {
  passFg = 0;
}

比較文を減らすことを意識した例

passFg = 0;
if (70 <= sum) {
  passFg = 1;
}

コメントをつける

プログラミングをする時にコメントをつけることをオススメします。

プログラム中にコメントがあると、コーディングした人以外が見た時にその処理は何のためにあるのか？などプログラムの内容が分かりやすくなります。

コメントを記載した例

passFg = 0;

// 合計値が70以降の時にフラグをONにする
if (70 <= sum) {
  passFg = 1;
}

経験値を実践ではなく読むだけで得られるようにしていきたいと考えています。

名前の付け方

プログラミングをしていると下記項目に名前をつけると思います。

• クラス名
• 変数名
• 関数名
• テーブル名（DB)
• テーブルの項目名（DB）

名前を決める時、その名前を見て内容が分かるような名前をつけることをオススメします。

プロジェクトでプログラミングする場合、プロジェクト毎に命名規約などがあるかと思います。その際はプロジェクトの命名規約に則って名前を決めるようにしてください。

命名規約など規約がない場合は、下記規則に則って名前を決めることをオススメします。

体験談

料金を計算するプログラムで下記内容の変数名・DB項目が設定されていた。

仕様変更により「高校生・幼児」を追加することに…。 

参考にするプログラムコード

インターネット上にはサンプルコードがたくさんありますが、サンプルコードを理解せずにコピペすることやめてください。

理解せずにサンプルコードを使うと下記のことが考えられます。

• 業務に沿ってない処理
• 不要な処理がありバグの原因になる

サンプルコードを参考にする場合は必ず理解した上で使うことをオススメします。

体験談

スピードを求めてサンプルコードを組み合わせて使用。仕様変更の際の打合せで処理内容の質問に対して答えられなかった。

分かりやすいコーディング

下記2点を気をつけて、シンプルにコーディングすることをオススメします。

• 自分以外がみて読みやすい
• 自分以外がみて分かりやすい

体験談

仕様変更によりプログラムの解析。仕様は簡単でしたがプログラムコードがすごく長い。簡単なことが複雑にコーディングされていて解析・検証がすごく大変な思いをした。