コメントの書き方

コメントって何だろう？

コードを書いていると「ここは何をしているんだっけ？」と後から迷うことがあります。

そんなときに使うのがコメントです。コメントとは、コードの中に書けるメモのことです。コンピューターはコメントを無視するので、プログラムの動きには一切影響しません。

1行コメント

//（スラッシュ2つ）から行末までがコメントになります。

1public class Main {
2  public static void main(String[] args) {
3      // ここから画面に表示する
4      System.out.println("Hello, World!");
5  }
6}

// より右側はすべてコメントとして扱われ、プログラムには影響しません。

複数行コメント

/* で始めて */ で終わると、複数行にわたるコメントが書けます。

1public class Main {
2  public static void main(String[] args) {
3      /*
4        このプログラムは
5        Hello, World! と表示するだけです
6      */
7      System.out.println("Hello, World!");
8  }
9}

長い説明を書きたいときに使います。

コメントアウトで動作確認

「この行がなかったらどうなる？」と確認したいとき、コードを削除してしまうと元に戻せなくなります。

そこで使うのがコメントアウトです。コードの先頭に // をつけるだけで、その行を一時的に無効にできます。

1public class Main {
2  public static void main(String[] args) {
3      System.out.println("おはよう");
4      // System.out.println("こんにちは"); ← 無効になっている
5      System.out.println("こんばんは");
6  }
7}

実行結果：

1おはよう
2こんばんは

「こんにちは」の行はコメントアウトされているので実行されません。削除せずに残しておけるので、あとでコメントを外すだけで元通りになります。

どんなときにコメントを書く？

コメントが役に立つのは次のような場面です。

• そのコードが「なぜ」その書き方をしているかを残したいとき
• 後から見た自分（や他の人）が迷いそうな部分

コメントが多すぎるとかえってわかりにくくなることもあるので、本当に必要な場所だけに書くのがポイントです。