動くコードは書ける。でも半年後の自分や、初めてそのコードを読むメンバーがすぐに理解できるかというと自信がない。読みにくいコードは、書いた瞬間は問題にならなくても、後からのレビューや保守で確実に時間を奪っていく。『リーダブルコード』は、その「読みやすさ」を具体的な技術として教えてくれる、今も色褪せない一冊だった。
「理解しやすいコード」という一貫した原則
本書は第1章「理解しやすいコード」という原則から始まり、その原則を日々のコーディングのあらゆる場面に当てはめていく構成になっている。第I部の「表面上の改善」では、名前に情報を詰め込む方法や誤解されない名前の付け方、コメントの書き方といった、明日からすぐ実践できるレベルの技術が並んでいる。
制御フローからテストまで、地に足のついた範囲
表面的な改善にとどまらず、制御フローや論理式、変数の扱い方、コードの再構成、そしてテストの書き方まで踏み込んでいる。イラストを交えた解説で読みやすく、日本語版には須藤功平さんによる解説も収録されている。技術トレンドに左右されない、コードそのものの本質的な部分を扱っているのが強みだと感じた。
読んでよかったポイント
- 「名前に情報を詰め込む」章を読んでから、変数名を考える時間そのものが短くなった
- 誤解されない名前の付け方が、レビューでの「これってどういう意味ですか」というやり取りを減らしてくれた
- コメントの書き方の章で、コードの動きを説明するコメントと意図を説明するコメントの違いを意識するようになった
- 制御フローの整理の仕方が、ネストの深いif文を見直す具体的な手がかりになった
- テストの書き方を扱う最後の章が、読みやすさの話をテストコードにまで広げてくれていて視野が広がった
さらに広げて読むなら
「動くコード」から「読めるコード」への意識の切り替えをもう一段深めたいなら、「動くコード」を書けるのに「読めるコード」が書けない人へ。持続可能な設計思考を身につける一冊も合わせて読むと、リーダブルコードの実践を設計思考のレベルまで広げられる。
まとめ
読みやすいコードは才能ではなく技術で、意識すれば今日から変えられる部分が多い。次にコードを書くときは、まず変数の名前を一つ、この本の基準で見直してみてほしい。