リーダブルコードまとめ
リーダブルコードまとめ
変数名
- 上限下限を表す時はmax, minなどを使用
- 範囲であればfirst, lastを使用
コードの形態
- 同じような処理を行っている部分はシルエットが同じようになるようにする
- 意味のある順番を選んでそれを守る
- 空行を使ってコードを意味のあるまとまりに分割する
- 列を整列する
コメント
- コードからすぐにわかることをコメントに書かない
- コードをみて疑問に思うこと、気をつけることをコメントにする
- 具体的かつ適切な言葉を選ぶ
制御フローについて
- 口語で読み下せるように条件を記述する(ex.もし18以上なら)
- 変化する値を左に、安定した値を右に書く
- 制御フロー変数を使わずに書く。
巨大な式を分割する
- 条件分岐の条件が一目でわかるように説明変数を用意する