プロフィール

学ぶパンダ

初心者向けにプログラミング学習や

就職・転職に向けた情報を発信

【プログラミング初心者向け】コードの理解のために、ソースコードのコメントをたくさん書きましょう。

初心者の方は、

プログラミング学習を始めて、

いろいろなコードを書いては、

試行錯誤しながら、

自分なりに理解を深めていくことが大切です。

そんなプログラミング初心者の方が、

プログラミングのコードを書く上で、

1つ、学習していく中で、

取り組むと良いことの1つが、

ソースコードに自分なりのメモを書き込む

という方法です。

コードを書くことでどのように良いのか、

また、どのような点に気をつけると良いかなど、

この記事で説明していくので、

プログラミング初心者の方は参考にしてください。

【プログラミング初心者向け】コードの理解のために、ソースコードのコメントをたくさん書きましょう。

ソースコードのコメントとは?

プログラミングをしていく中で、

ソースコードを書く必要性がでてきます。

例えば、

if(a > 10) {
   :
}

このような処理のプログラムのコードを書いたときに、

この処理が何を行なっているかを、

その直前に書くのが「コメント」です。

上記の例では、

// これは「a」の値が10より大きいかを判定する
if(a > 10) {
   :
}

このように、

処理の上にコメントを書くことで、

自分なりのメモとして残すことができます。

実際の現場では、

あまりにも不要なコメントは控えるように指示があるかもしれませんが、

プログラミング初心者の方が、

自分の学習として始めている段階であれば、

コメントはたくさん書いても問題ありません。

コメントをたくさん書くメリットは?

このコメントをたくさん書くということは、

書籍を読んだりするときの、

必要に応じてメモを残すことと同じで、

自分なりのメモをコード上に残せるということが、

メリットとしてありますが、

プログラミング学習をしていくという点では、

  • コメントを書くことで頭の中の整理ができる
  • 自分のコードを見直すときに意図が思い出しやすい
  • コメントの流れを読むことで処理の理解が進みやすい

というメリットがあります。

この3つのメリットは、

プログラミングに慣れてくると、

コメント自体を少なくしても、

自分の頭の中で把握してできるようになりますが、

プログラミング初心者が行う上では、

非常にメリットになるので試してみましょう。

コメントを書くことで頭の中の整理ができる

プログラミングをしていく中で、

「自分の書いたコードを頭の中で整理する」

ということが大切です。

これには、

プログラミングで自分が描くコードに対して、

「どのような意図でこのコードを書いたのか」

ということが、

自分の中でしっかりと考えられていれば、

学習をしていく中でも問題にはなりません。

この点に関して、

コメントを追加していくことで、

「プログラミングコード」と「コードの意図」が結びつく

ことで、

自分の頭の中にも残りやすくなるので、

コードを書いている時に、

そのコードに対して自分の理解がある状況で、

コメントを残しておくと良いでしょう。

自分のコードを見直すときに意図が思い出しやすい

コメント自体を残すことで、

コードの理解がより深まることを説明しました。

そんなコメントを残すことで、

初心者の学習の時によくある、

「コードを書いているときは覚えていたのに」

という悩みを、

解決につなげやすくなるメリットがあります。

これは、

他人の説明ではなかなか理解ができなくても、

「自分の言葉で書いてある説明なので腑に落ちる」

ということがあり、

過去の自分が残したコメントを読むことで、

そのコードの意図を思い出しやすくなります。

このメリットは、

学習を進めていく中で、

学習の手戻りが増えてしまうことも防ぐので、

継続的に学習を続けていくためにも、

コメントを残すようにすると良いでしょう。

コメントの流れを読むことで処理の理解が進みやすい

プログラミングの学習を進めていくと、

  • プログラミングコードの量が増えていく
  • 処理が少しずつ、複雑になっていく

になることが多く、

学習の最初のうちは理解できたけれど、

コードが長くなると、

「全体として何をしているかわからない」

となってしまう初心者の方もいます。

そのような時に、

自分なりにしっかりとしたコメントを残しておくことで、

「コメントを順に読むことで、全体の処理が理解しやすい」

というメリットがあります。

このメリットは、

継続を続けていけばいくほど、

コメントをしっかりと残しておくことが、

将来の自分自身の学習を助けるので、

学習の初期段階からコメントを残すようにすると良いでしょう。

プログラミング初心者が他に大切なことは?

この記事で、

プログラミング初心者の方が、

コメントを残すことで、

学習する自分自身にメリットがあることを説明しました。

そんな学習をやっていく初心者の方に、

他にも大切にして欲しいことがあります。

その大切にして欲しいことは、

以下の記事を参考にして、

学習に取り組んでください。

ピックアップ

初心者にオススメ

おすすめ記事