リーダブルコード より良いコードを書くためのシンプルで実践的なテクニック

ダスティンボズウェル, トレバーフォシェ【著】, 角征典【訳】

• 販売会社／発売会社: オライリージャパン/オーム社
• 発売年月日: 2012/06/25
• JAN: 9784873115658

商品レビュー

2026/10/22

『リーダブルコード』（Dustin Boswell、Trevor Foucher 著 / 角 征典 訳）〈オライリー・ジャパン〉

他人に分かりやすく伝えるというのはとても大事だと思います。
この本はコーティングがテーマですが、「人に分かりやすく伝えるにはどうすればいいか」という観点は全く同じですし、考え方も共通するものがありました。
簡単に要約すると、「見た目をスッキリさせる」「似た話題は固める」「あれこれ詰め込まず、必要なら分けて書く」「分かりやすい言葉を使う」ということかな、と思います。
「分かりやすい表現を学ぼう！」と考えてこの本を選ぶ人はいないと思いますが、期待以上のいい作品でした。

2026/10/17

## 関数
- 関数、関数内に要約コメントを入れる
- ひどいコードを補うため、補助的にコメントを追加するのではなく、コードを修正する
- コードを見てわかることはコメント入れない
- 汎用コードを作成する例）ファイルを読み込み、一行に書かれた値をリストに入れる
- エラーメッセージを返す関数を作成すると一貫性が出る

## 変数
- 大文字、アンダーラインに意味を持たせる
大文字から始まる場合は、定数
アンダーラインが末尾につく場合、グローバル変数など
- 変数名に大切な情報を追加する
・時間など単位があるものに変数をつけるときは『waitTime』ではなく、
　『waitTime_sec』で表す。イテレータも『i』ではなく、『member_i』、『mi』などを使用する
- bool値の変数に名前をつける場合、『is_』、『has_』を使用する
- スコープで変数名の長さを調整する
スコープが長い場合、変数名を具体的で長いもの。
スコープが短い場合、変数名は短くても良い

## コーディング考え方
- コードは短くした方が良いが、それより『理解する時間までの時間』を減ら
- 段落は同じ幅で作成する
- コードもより簡単な言葉で書くことで読みやすくなる
- 否定形を使用すると読みにくさが増す
- 『ラバーダッキング］問題を口に出して説明するだけで、解決策が思いつく

2026/07/05

これは本当に名著だった。コーディングする人もコーディングレビューする人も全員この本読むのを義務化してほしい