お疲れ様です。
年末年始に差し掛かり、まとまった時間があったので何冊か本を読みました。
数年前に一度読んだ「リーダブルコード」という本を読み返したところ学びがあったので、
備忘を兼ねてご紹介させていただければと思います。
リーダブルコードから学ぶ「読みやすいコード」の本質
「動くコードは書けるけど、読みやすいコードって何だろう？」
そんな疑問に正面から答えてくれるのが、Dustin Boswell / Trevor Foucher 著の名著『リーダブルコード』です。
本書のテーマはとてもシンプルで、「コードは他人が読んで理解できてこそ価値がある」という一点に集約されます。
読みやすさは“思いやり”
リーダブルコードで繰り返し強調されるのは、「コードは書く時間より読まれる時間のほうが圧倒的に長い」という事実です。
未来の自分、同僚、後任のエンジニアが最短時間で理解できるか。
それを基準に書かれたコードは、結果としてバグが少なく、修正もしやすくなります。
良い名前は最高のコメント
変数名や関数名は、コードの第一印象を決めます。
本書では `tmp` や `data` のような曖昧な名前を避け、「何を表しているのかが一目でわかる名前」を付けることの重要性が語られます。
また、単位や状態を名前に含める（`elapsedSeconds` など）ことで、誤解を未然に防ぐことができます。
コメントは「なぜ」を書く
コメントは多ければ良いわけではありません。
コードを読めば分かることを説明するのではなく、「なぜその実装にしたのか」「何を意図しているのか」を補足するのが良いコメントです。
コードで表現できることはコードで、背景や判断理由はコメントで書く。
この住み分けが重要です。
見た目を整えるだけで理解度は上がる
インデント、改行、処理のまとまり。これらを整えるだけで、コードの理解速度は大きく向上します。
人は視覚から多くの情報を得るため、処理の流れが“見える”コードは、それだけで読みやすいのです。
まとめ
『リーダブルコード』は、テクニック集であると同時に「エンジニアとしての姿勢」を教えてくれる本です。
「このコードは他人に優しいか？」
そう自問する習慣こそが、読みやすいコードを書くための第一歩なのだと感じました。
