良いコードってどんなコードですか？という質問を受けたら何と答えるか - snoozer05's blog

技術顧問先で、一生懸命コードに向き合っているプログラマーになりたての方から、次のような質問をもらいました。 最初に面談した時、1年後にいいコードが書ける、上手に書けることを目標にしましたが、 先日スクール時代の同期（それぞれRubyの会社で働いている）と話したところ、会社ごとにレビューの仕方やコードに関する基準がさまざまなようで、良いコードとはなんなのか疑問に感じました。「いいコード」とは、みたいな部分で島田さんの考え方をお聞きできたら嬉しいです。 この質問にぼくは次のような回答をしたのですが、「この質問が来たら他の人はどんな回答するんだろうな」に興味があるので、ここにしたためておきます。もしよかったら「若者にこれを聞かれたら自分ならこう答える」をコメントなどで残していってもらえたら嬉しいです。 とても大事な疑問を見つけられたんだなあと思います。 「良さとは何か」ということに向き合う必要の

[l__LINE__l]

読みやすさ、メンテナンスしやすさ、パフォーマンス考慮、セキュリティ考慮

[t-wada]

理解容易性、変更容易性、テスト容易性がそれぞれ高いコードのことだと考えています

[himajin_sanjin]

読みやすくて、バグの多いコードだ。楽な仕事が増えるだろ。

[s-nanagi]

費用対効果が高いコード（工数に絞った文脈）。主に可読性、変更容易性、テスト容易性が考慮されていて将来の開発を妨げずオーバーエンジニアリングではない実装を指すが、最初は可読性とテストを書くことからかな。

[koogawa]

書き手の意図が伝わりやすいコード、事業を前に進めるコード🧑🏻‍💻

[knjname]

必然性と意図が感じられるコードかな　冗長なのも困るがゴルフも困る　しかし現場で遭うのは本人も書いてる内容わかってねーだろというそれ以前の問題のコードだらけ　そういうのじゃなければ別に

[honeybe]

意味単位で短めにまとまっていて何をやりたいか、何をやっているかが解りやすい見通しの良いコードが好きです。

[tanatana456]

過度な共通化が一番つらいのでそれさえなければ…

[toria_ezu1]

適度にコメントが記載されているコードでしょ。未だにコメントを一切書かない人がいるし

[w1234567]

1年後読み返したときに誰がこのクソコード書いたんだ、あっ、自分だってならないコードが良いコード

[pmint]

挙がるのはみんな測定もできないメタ回答で。全部を具体化すると「コピペしやすいコード」になる。/ 「クソコード」を論う動画が改善後もクソコードだったりする。良いコードが何なのか知らずに教えたがる人は多い。

[rryu]

悪くないコードと良いコードは別物で、良いコードはドメイン特化なので答えが一つにならない。悪いコードの意見は一致するので、まずはその轍を踏まない悪くないコードを目指すべきだと思う。

[sds-page]

保守性が高いコードかな。一回動けばいい、自分だけが読めればいいってのもあるけどそういうのプログラミングにする意味ないよね

[naari_3]

いい記事

[d_hack0928]

細かい条件無しなら、理解しやすくて変えやすいコードと答えます。その役割において優れたコードであるかと、多種多様な人と共同管理しやすい状態であるかは、分けた方が討議しやすそうです

[onigra]

高凝集、低結合

[suizumasahar01]

何度も読み返さなくても処理の内容と処理の意図が理解できるコードだとかなり助かる。

[Shinwiki]

動くコード

[cinq_na]

これは簡単。他人や未来の自分が読みやすいコードが正解。そうすれば改修性とかも自然と高まるはず。もちろん、既存の読みやすいコードを書くノウハウはありがたく参考にするべき。

[baronhorse]

読みやすく、変えやすく、効率の良いコード。メタみたいな話に逃げてケムに巻いてくる顧問とかがっかり過ぎるな。

[asada_bao]

タイトルだけ見て「存在しないコード」だと思ったけどそういう話じゃなかった

[puruhime]

良いコードのトレンドが変わっていくから、禅問答になるよね

[sigwyg]

捨てやすいコードであることと、WHYにつながる導線があること。後者はPRちゃんと書くでも代用できる。

[yamadadadada2]

理解しやすいコード。ただ、そもそもビジネス要件が難しくて、どうしても分かりづらい実装になることはよくある。そこをどう乗り越えていくかが仕事なのかなと

[hecaton55]

コーディングの話なのか設計の話なのか。モジュールレベルの設計がうまくなるとコードの粒度も理解しやすい範囲でまとまるという認識（あくまでもモジュールレベルの考え方の話なので設計書を作れではない）

[modal_soul]

良いコードに対する"価値観"自体も成長のバロメーターなんだと思ってる。知識や経験を積み重ねることで、良さを測り表現する切り口も増えたり、洗練されていくのだと思う

[deep_one]

分かりやすいコード。

[hjmk]

良いコードは何も無いコードだ。なんたってバグ0だからな。

[mricopp]

いい質問だなー。勉強になります。

[lycolia]

一貫した設計とコードがあり、疎結合で適切な責務で分割され、テストが容易なコードだと思っているが、全ての開発に当てはまるわけではないので正解はないと思う

[nemoba]

そもそも良い人間って誰ですかね？って返す。ちなみに次の質問は、"なぜ"それが良いのですか？

[ku__ra__ge]

少ないチャンクで読めるのが、良いコードです。

[aroechan]

循環的複雑度/凝集度/結合度 とかある程度「コードの良さ」を定量化/定性化するための指標はあるものの、命名の良さとかはこれでは測れないから難しい所

[mayumayu_nimolove]

良いプロダクトはコードが汚く、短命なプロダクトはやたらコードが綺麗だったりする。なぜか？

[magi00]

取りあえず動くコードであれば可読性やメンテナンス性はAIがどうにかしてくれそうだけど