TL;DR

読み取れる性質や、その度合い。プログラミングでは、ソースコードを人間が読んだときの、その目的や処理の流れの理解しやすさを指す。

なぜ必要か

ソースコードを保守するのは人間なので、可読性は重要である。Wikipedia によると、可読性の低いコードはバグを生みやすく、重複したコードによる非効率も生じやすい。

仕組み

適切なコメントは理解を助ける。字下げ、問題の分け方、命名規則など、コーディングスタイルの規則の多くは、主に可読性のためのものである。

例

Effective TypeScript 項目19 では、1 つの変数を異なる型の値に使い回すと、値が変わって処理を追いにくくなり、変数名も抽象的になるので、可読性が下がるとしている。また、項目27 では、コールバックで書いた非同期処理はネストが深くなり、実行順序がコードの順序と逆になるなど、可読性が低かったとしている。

注意点

誤ったコメントが残っていると、かえって誤読につながる。また、熟練者には定番で簡潔な書き方が、慣れていないプログラマには読みにくく感じられることもあり、可読性は読み手の力量にも左右される。

関連

出典