【ISSUE】リーダブルコードを読んで
2024年12月23日 8:40
リーダブルコードを読んで、勉強になったこと、感じたことをまとめていきます。
・コードは理解しなければならない
・コードは他の人が、最短時間で理解できるように書かないといけない
1つずつ説明していきます。
これがコードを書くうえで、一番大事になる原則としている。
コードを読む際に、処理内容が分かりにくいコードよりも、わかりやすいこコードの方が良いに決まっています。
わかりにくいコードを書いていると、周りの開発者はもちろん、何ヶ月後かに、自分で見返した時にも、コードを読むのに労力を使ってしまいます。
・明確な単語を選ぶ
・汎用的な名前は避ける
・抽象的な名前よりも具体的な名前を使う。
・接尾辞や接尾頭を使って、情報を追加する
・名前の長さを決める
例えば「getPage」という名前は、ページをどこから取ってくるのかわからない。インターネットから取得するのであれば、「FetchPage」、「DownloadPage」などが良い。
例えば、「tmp」「retval」「foo」のような名前は付けないようにしたほうがいい。
単語自体に情報が無いので、使うのであれば、それ相応の理由を用意する。
名前は短いコメントのようなものなので、絶対に知らせなきゃいけない情報があれば、適切な単語を選び、変数名に追加する
この本では、変数の長さは、長いのが問題ではないが、できるだけ短くすることをおすすめしている。
理由としては、長い変数は覚えにくいし、画面を占領してしまうからです。
頭文字と省略形はプロジェクト固有の省略は良くない。理由は、新しく入ってきたメンバーはその変数の意味を理解できないからである。
不要な単語も投げ捨てた方がいい。例えば、CovertToString()をToString()にしてもあまり変わらない。
変数名はシンプルにしよう。
・最善の名前とは、誤解されない名前
自分の書いているコードが、自分の意図を正確に伝えるようにする。
プログラミングの英単語は、filterやlength、limitなど曖昧な意味の単語が多い。
例えば、上下の限界値を決めるときは、maxやminなどを使う。包含的範囲であればfirstやlastなどを使うなど、工夫をしていくことが必要である。
プログラミングの時間のほとんどはコードを読む時間です。読みやすいコードは、コーディングのミスを減らし、誰でも使いやすいコードになるのです。
・複数のコードブロックで同じようなことをしていたら、シルエットも同じようなものにする。
・コードの列を整列すれば、概要が把握しやすくなる
・空行を使って大きなブロックを論理的な段落に分ける。
全ての内容を書ききれていないので、また追記していきます。
[cv:issue_marketplace_engineer]
診断を受けるとあなたの現在の業務委託単価を算出します。今後副業やフリーランスで単価を交渉する際の参考になります。また次の単価レンジに到達するためのヒントも確認できます。