2022.10.05

【CleanCode】より良いコードを書く技術 ①

おかざきるい

こんにちは!RuiOkazakiです!
今回からシリーズとして【CleanCode】読みやすいコードを書く技術について記事を書いていきます!
「初心者だから…」「いいコードとかわからないし…」など感じた人でも読みやすいような内容を心掛けたいと思います!

  1. 導入編( ← 現在のページ )
  2. 命名規則編
  3. コメント編


クリーンコードとは

  • 読みやすい
  • 機能の追加、修正がしやすい

などの特徴を持ったプログラムのことです。

学ぶことで得られる恩恵

  • 将来の自分や他人が読みやすいコードになり開発速度 / 開発体験が向上する
  • プログラムの処理が追いやすくなる
  • 機能の追加や修正がしやすい(影響範囲が限定される)
  • バグが混入しづらい
  • 無駄な部分まで読む必要がなくなる
  • テストがしやすい
  • 自分の書くコードに自信が持てます!
  • コードレビューに役立ちます

などなど…
少なくとも学んで損はしない内容だと思います!

読みやすいコードとはどんなコード?

  • 読んでいて疲れない
  • 必要以上に読ませない
  • 命名が適切にされている
  • コメントがなくても関数名だけで挙動 / 値がわかる

などが挙げられます。

「わかりやすいコード = コメントがたくさん書いてある」

などと勘違いされがちですが、案外そういうわけでもないです!

「コメント=わかりやすさ」 にならない理由

  • コメントを書くのが冗長なケースがあるため
  • コメントがメンテナンスされ最新の状態であるとは限らないため
  • コメントよりコードの方が挙動を正確に表現できるため

上記の理由から
コードで実装の意図を伝えることが1番大切だと考えています!

クリーンコードを適用しない方が良いケース(例外)

主に下記の理由がある場合クリーンコードを意識しすぎるのもよくないと思います><

  • パフォーマンスを意識したコードを書く必要がある場合
  • 速度重視の開発をする場合

正直現場によってケースバイケースだと思うので100%どんな時でも正しい!という心持ちはトラブルの元になりかねないので注意しておきましょう。

まとめ

ご清覧ありがとうございました。
命名規則編へ

  • 初心者
  • JavaScript

おかざきるい

フロントエンド中心にコード書きます。邦ロックとアイスとカメラが好きです。

トップページへ戻る

こちらの記事もおすすめ

【時短したいあなたに!】MacBook に入れるべきアプリ 23選のサムネイル

2022.08.02

【時短したいあなたに!】MacBook に入れるべきアプリ 23選

おかざきるい

【初心者向け】ロゴデザインで抑えておきたい3つのポイントのサムネイル

2022.06.08

【初心者向け】ロゴデザインで抑えておきたい3つのポイント

さとうまなみ

【CleanCode】より良いコードを書く技術 ①のサムネイル

2022.10.05

【CleanCode】より良いコードを書く技術 ①

おかざきるい