良いコードの基準はなんでしょうか

テーマ・知りたいこと

良いコードの条件はなんでしょうか?
可読性、変更に柔軟にたいしょできること？

回答13件

TakaiY

総合スコア14039

投稿2025/02/13 10:31

一言で言うなら、「読んで理解しやすいコード」だと思います。

いろいろな取り決めなどは、それを実現するための手段という理解です。

meg_

総合スコア10825

投稿2025/02/13 10:48

良いコードの基準はなんでしょうか

下記の様な"悪いコード"ではないことでしょうか。

変数名が長すぎる、短すぎる
ループのネストが深すぎる
適切なライブラリを使用していない（独自実装に拘る）
コメントが無い・不足している
リソースを無駄遣いする

普通のコードで”良いコード”だと思います。

utm.

総合スコア526

投稿2025/02/13 10:59

編集2025/02/13 11:08

自分で考えてもいいですが、Wikipediaのソフトウェア品質を参考にしてみるのもいいと思います。

:理解可能性
目的が明確である、あるいは明らか

:完全性
維持可能である

:簡潔性
無駄がない、不必要な内容や複雑な構造をしていない

:移植性
依存が最小限である

:一貫性
記法の一致

:保守性
改良(機能追加や削減)が容易

:試験性
不具合の発見が容易

:ユーザビリティ
学習が容易、体験が効率的、思い出しやすい、ミスが起きづらい、ストレスがなく満足度が高い。

:信頼性
継続的に動作する、回復の手段が用意されている、例外処理がある、健全な値チェックがされている

:構造化の度合い
整理されており、変更しやすく直観的な構造、必要な部分を見つけやすい

:効率性
動作が早い、リソースの使用が効率的、確保と解放が適切なタイミングに実行される。

:セキュリティ
不正や異常なデータの影響が防止されている

補足
ちなみに、時の流れによって色々変わる(あくまで品質の話だけど外してないと思う)
https://qiita.com/UT_ITDaiku/items/ae2c2ae83e7e6dbb1ee2

tmp

総合スコア312

投稿2025/02/13 23:23

状況で変わってくると思うのですが、書いてない条件はみんな勝手に想像して、大抵は自分状況的な条件で補われて、あなたの希望する回答は得られにくいのではないでしょうか？
適当でいい雑談なら問題ないですね

fana

総合スコア12079

投稿2025/02/14 07:47

良いコード

「誰にとって」良い　という話なのか，次第ということになる気がします．

例えば，簡単/初歩的な文法や機能だけを用いて書かれたコードは，上級者が見れば「もうちょっとなんとかならんのか」とか思えるでしょう（つまり，それは上級者にとっては良いコードではない）．
しかし，初心者にとっては可読性の観点で「良い」コードかもしれません．

sazi

総合スコア25354

投稿2025/02/15 00:52

少ないステップ数であること。
即ち、構造設計、共通化、制御構造が優れている。

shiketa

総合スコア4075

投稿2025/02/15 02:12

「コーディング規約」とタグがついているので、あなたの属するその組織そのチームで定義されたコーディング規約が存在する、という前提なのでしょう。そうであって、その組織で評価されたいのであれば、コーディング規約に沿っていること、なのでは。

taku0012

総合スコア18

投稿2025/02/15 07:30

所属する組織によってコーディングルールは変わることもありますが、一般的には新しく入ってきた人がコードを見るだけで処理内容が理解しやすいようなコードや改修しやすいコードが良いコードだと言えますね。これらの内容は「リーダブルコード」という技術本に詳しく載っているのでこちらを読むことをお勧めします。結構良い本です。