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

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

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

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

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

TechTarget発　エンジニア虎の巻

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

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

この記事の著者

関連記事

• 

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

• 

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

新着ホワイトペーパー PR

• 事例
  [フォーティネットジャパン合同会社] 複雑化しがちな「SASE運用」　IT・医療・金融などの事例に見る導入成功の秘訣
• 製品資料
  [フォーティネットジャパン合同会社] 「SD-WAN」導入で失敗しないための5つの重要事項
• 技術文書・技術解説
  [フォーティネットジャパン合同会社] VPNの代替候補「ZTNA」を理解できるようになる“3大要素”とは？
• 事例
  [フォーティネットジャパン合同会社] すぐ分かる「SD-WAN」選定のポイント　成功企業はどんな成果を出した？
• 製品資料
  [SCSK株式会社] 「Dropbox」管理・運用の困りごと解決ガイド