コグノスケ

コードの読みやすさとは

基本的には、コードを読むときに、覚えておかなければならないことを減らし、覚える時間を短く済ませた方がわかりやすい、と感じます。

コードを横長にするくらいなら、縦長にする。

一度に覚えることが減るから。

コードの横も縦も短くできれば、なお良い。

メソッドを読むときに覚え続ける時間が減るから。

引数は少ない方が良い。

メソッドの目的は1つが良い。

コードを読むときに覚える項目が減るから。

インデントは浅い方が良い。

ブロックを読むときに覚える条件の数が減るから。

意味のわからない変数名は無い方が良い。

マジックナンバーは無い方が良い。

名前と名前の意味を対応させる必要がなくなるから。

グローバル変数は無い方が良い。

ソースコード全域で覚えなければならない項目が減るから。

副作用は無い方が良い。

覚える必要すらなくなるから。

覚えきれない量の条件や変数が出てくるコード、長時間覚えておかなければ理解できないコードは、どこかが病気だと思って、直すようにしています。