編集部からのお知らせ
「ZDNet Japan Summit」参加登録受付中! 
新着記事集:「負荷分散」

粗悪なコードを覆い隠す?--「コードにコメントは不必要」派の意見は妥当か

ZDNet Japan Staff

2020-01-11 08:00

 コードにコメントを付けるべきだろうか。答えはもちろん、イエスである。と同時に、ノーでもある。

 冗談はさておき、「まずはコメントに頼らなくても理解できるように、なるべくシンプルなコードを作成するように努める。これ以上分かりやすいコードは書けないというところまで到達してから、コメントを書き始めるべきだ」

 これはJeff Atwood氏が2006年に記した内容だが、当時と同様に、現在の状況にも当てはまる。むしろ現在の方がもっと、真剣に捉えるべきかもしれない。

コメント否定派の意見

 このトピックを持ち出すと必ず(そしてすぐに)、コードをコメントで煩雑にすべきでないと主張し、その理由を述べる人が現れる。コメント反対派の代表的な意見の1つが、コメントはコードのシグナルにとってノイズとなる、というものだ。

 「優れたコードとは自己文書化されたコードである」という言葉があり、コメントの追加は時として、粗悪なコードを覆い隠してしまい、プラスの効果が得られないことがある。Bennett Garner氏は次のように書いている

(本記事は、TechRepublic Japanで2019年10月3日に掲載した記事からの転載です。続きはTechRepublic Japanでお読みいただけます)

ZDNet Japan 記事を毎朝メールでまとめ読み(登録無料)

特集

CIO

モバイル

セキュリティ

スペシャル

ホワイトペーパー

新着

ランキング

  1. クラウドコンピューティング

    Google Cloudセキュリティ基盤ガイド、設計から運用までのポイントを網羅

  2. セキュリティ

    仮想化・自動化を活用して次世代データセンターを構築したJR東日本情報システム

  3. ビジネスアプリケーション

    スモールスタート思考で業務を改善! 「社内DX」推進のためのキホンを知る

  4. セキュリティ

    Emotetへの感染を導く攻撃メールが多数報告!侵入を前提に対応するEDRの導入が有力な解決策に

  5. セキュリティ

    偽装ウイルスを見抜けず水際対策の重要性を痛感!竹中工務店が実施した2万台のPCを守る方法とは

NEWSLETTERS

エンタープライズ・コンピューティングの最前線を配信

ZDNet Japanは、CIOとITマネージャーを対象に、ビジネス課題の解決とITを活用した新たな価値創造を支援します。
ITビジネス全般については、CNET Japanをご覧ください。

このサイトでは、利用状況の把握や広告配信などのために、Cookieなどを使用してアクセスデータを取得・利用しています。 これ以降ページを遷移した場合、Cookieなどの設定や使用に同意したことになります。
Cookieなどの設定や使用の詳細、オプトアウトについては詳細をご覧ください。
[ 閉じる ]