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

IT
スポンサーリンク

おそらく数年エンジニアをやっている人で

聞いたことがない

見たことがない

なんてことは絶対にないこの本の紹介です。

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

面白いと、読みやすいは、違うんだよ?
こんな前書きで始まるリーダブルコード。タイトル通り「読みやすいコード」をテーマとした名著です。読みやすさと面白いは全くの別物。面白いことをする必要はなく、ただ『良い名前』、『適切なコメント』、『意味ある単位に分ける』といった綺麗で洗練されたコードを書くために必要なことを学びました。

プログラミング言語の学術書は多いけど、こういった暗黙知の部分に関する名著は少ない。
そういったいいでも本当に素晴らしい名著だと思います。

理解しやすいコードとは?

コードは他の人が最短時間で理解できるように書く。

3つのステップ。
1.実際にやる
2.それを当たり前にする
3.コードで伝える

1.は実際に読みやすいコードを書いてみること。難しく、賢いようなコードはなにより読みづらい。
2.読みやすいコードを書くのが当たり前になるなるようにする。デフォルトで読みやすいコードを書くようにする。頭でっかちな賢いふりしたコードほど読みづらいものはない。賢くなくて良い。見やすく、洗練された、シンプルなコードがなによりも美しい。
3.文字通り「読みやすいコードを書いて伝えること」。読みやすいコードとはどんなものなのかを、実際のコードで伝える。

名前に情報を詰めること

・明確な単語を選ぶ
・汎用的な名前は避ける
・具体的な名前を使用するようにする
・必要な情報(単語)を追加する
・名前の長さを決める
・名前のフォーマットで情報を決める

誤解を生まない名前

・名前が他の意味に捉えられることはないか考えよう。

コードに美しさは必要

・読み手が慣れているパターンのレイアウトで書く
・似ているコードは似ているように書く
・関連するコードはまとめてブロックにする

コメントするべきこと

・コメントの目的は、書き手の意図を読み手に知らせることである

コメントは正確で簡潔に

・コメントは簡潔で情報を多く含むように書かなければならない

合わせて読みたい名著

CODE COMPLETE 第2版 <上><下> 完全なプログラミングを目指して

コードの品質などソフトウェアの構築に関するあらゆる側面についてよく調査されたもはや学術書。

Amazon:CODE COMPLETE 第2版 上 完全なプログラミングを目指して
楽天:コードコンプリート(上)第2版 完全なプログラミングを目指して [ スティーヴ・マコネル ]

Amazon:CODE COMPLETE 第2版 下 完全なプログラミングを目指して
楽天:コードコンプリート(下)第2版 完全なプログラミングを目指して [ スティーヴ・マコネル ]

新装版 リファクタリング―既存のコードを安全に改善する

さまざまなリファクタリング手法の詳細なカテゴリー、コードを破壊することなく変更を加えるテクニック等の手順が記載されている名著。

Amazon:新装版 リファクタリング―既存のコードを安全に改善する
楽天:リファクタリング新装版 既存のコードを安全に改善する (OBJECT TECHNOLOGY SERIES) [ マーチン・ファウラー ]

Effective Java 第3版(予約販売)

Javaのプログラムを読みやすく、バグの少ないものにするための知識が記載された名著。
Javaに関わらず、多くのプログラミング言語に応用可能な知識のため、Javaを扱っていない人でも楽しめるはず。


Amazon:Effective Java 第3版

すでに発行されている第2版は下記。
しかし、2018年10月31日に販売予定のため、待ってから買ったほうが良いでしょうね。
楽しみです。購入予定です。

Amazon:EFFECTIVE JAVA 第2版 (The Java Series)