📖

【リーダブルコード】 コードは理解しやすくなければならない

に公開

※ 下記のリンクにある本の韓国語版を読んで簡単に整理しました。
https://www.amazon.co.jp/Art-Readable-Code-Practical-Techniques-ebook/dp/B0064CZ1XE

コードは理解しやすくなければならない

コードは、他人がそれを理解するのにかかる時間を最小限にするように書かれるべきである。

以前は、かっこいいフレームワークやプロジェクトに携わっている人を「優れた開発者」だと思っていましたが、今では「変数名を絶妙に付ける人」「オブジェクトを上手に使ってコード量やバグを減らせる人」を優れた開発者として思い浮かべます。

「優れた開発者」とは、まさにこの引用の通り、「他人が理解するのにかかる時間を最小限にできる人」だと思います。

そのためには、変数名を適切に付け、他人が理解しやすいようにコードを書く努力を惜しんではいけません。成長するためには、まずは簡単なことから意識し、変数名の見直しや、重複したコード・乱雑なコードの修正から始めるべきです。一時的に見逃すことはできても、それを放置すると自分のコーディング力もその程度で止まってしまいます。数日後には修正するのが面倒になって、結局は放置しがちになります。だからこそ、「気づいたときにすぐ直す」ことが成長につながると感じています。


コード量が少なければ常に良いのか?

コード量が少ないからといって、常に良いとは限りません!

コード量が少ない例(Java版):

assert ( ( (user = login(id, pw)) == null ) || !user.isAdmin() );

コード量が多い例(Java版):

user = login(id, pw);
if (user != null) {
    assert !user.isAdmin();
}

この例は、Javaコードに変更しました。


Chapter 1の印象

Chapter 1 を読んで、「この本を最後まで読めば、他人にとって理解しやすいコードを書けるようになるかもしれない」という期待感が湧いてきました。


Discussion