プログラマーが知るべき「良いコメント」の条件【第1回】

「コメント」の“本当の意味”を誤解していないか？

ソースコードにおいて「コメント」は重要だ。ところが内容や意図が分からないコメントはよくある。書き方によっては、自分が書いたコメントさえ“判読不能”になることも。そもそもコメントとは何のためにあるのか。

　ソースコードにおける「コメント」は、プログラミングの基本的な要素だ。にもかかわらずプログラマーの間で、コメントの本来の意味が十分に理解されているわけではない。コメントを正しく理解して使いこなせるかどうかが、ソースコードをより良いものにするか、あるいは混乱を招くものにするかの分かれ目となる。

そもそも「コメント」は“あれ”のためにある

TechTarget発　エンジニア虎の巻

米国TechTargetの豊富な記事の中から、開発のノウハウや技術知識など、ITエンジニアの問題解決に役立つ情報を厳選してお届けします。

この連載の記事をもっと見る

この記事の著者

関連記事

• 

  「Python」と「Go」のソースコードを比べて分かる「インデント」の違いとは？

• 

  命令型プログラミングと宣言型プログラミングの「ソースコード」の違いとは？

新着ホワイトペーパー PR

• 事例
  [サイボウズ株式会社] DXに必要な「Dスキル」「Xスキル」を持った人材を育成するには？
• 市場調査・トレンド
  [サイボウズ株式会社] データで見る、DXが「順調に進む企業」と「つまずく企業」の違い
• 製品資料
  [サイボウズ株式会社] 賛否が割れがちな「Notesからの移行」　新環境への移行を納得してもらうには？
• 事例
  [ServiceNow Japan合同会社] 農林中金に学ぶ内製開発　処理効率を約2倍に高めAI活用も加速させた方法とは？
• 事例
  [ServiceNow Japan合同会社] NTTグループのデジタル変革術、17万人が利用する決裁プロセス刷新の全貌