特定のファイルのコードの最大行数について、評判の良いソースからの推奨事項を誰かが知っているかどうか知りたいと思いました。たとえば、GoogleのClosure Linterは、各行が80文字を超えないようにすることを推奨しています。
特定のファイルのコードの最大行数について、評判の良いソースからの推奨事項を誰かが知っているかどうか知りたいと思いました。たとえば、GoogleのClosure Linterは、各行が80文字を超えないようにすることを推奨しています。
回答:
ファイルは、何度もスクロールしたり探したりせずに検索したり、検索文字列を覚えたりしなくても、関数やメソッドを見つけることができるほど短い必要があります。私が使用する測定基準は、ファイル内のコードの検索と読み取りの時間です。それが顕著になった場合は、ファイルまたはクラスをパーティション分割し直してください。
基本的なコードブロックの適切なサイズは、幅と高さの両方で十分に短いため、グループコードのレビュー時にその根本を投影でき、フォントが小さくて後ろの人がいないようにすべてを合わせることができます。会議室はそれを読むことができません。このサイズは、モバイルデバイスまたはタブレットだけを持っているときに、コードを説明するように呼ばれる場合にも役立ちます。
そのようなことはありません。もしあったとしても、使用している言語に大きく依存します(たとえば、アセンブラーでC#やJavaと同じことを行う)。
高水準言語については、この SOの議論を見ることができます。Java / C#の場合、メソッドごとに10〜20行が、Bob Martinが推奨する最大値です。それは関連がなく、クラスが何をすることになっているかに依存するので、ファイルに関する議論はありません。
1行あたり80文字の制限について-これは、パンチカードの時代への先祖返りです。とはいえ、行が長くなりすぎると、読みやすさが低下します。
ファイルと行の長さは、複雑さの二次的影響の測定であり、そのため非常に変動します。目指すべきは、特定の最大行数ではなく、不要な複雑さのないコードです。
長いファイルは、メソッド、サブルーチン、またはクラスが過度に複雑であることを示しがちです(多くのことをしている、十分に因数分解されていないなど)。
長い線は、式が過度に複雑であることを示す傾向があります。
それらは潜在的なコードの問題を示すにおいであり、明確に定義されたターゲット指標ではありません。
行の長さは、行全体を見るために画面をスクロールする必要がないような長さにする必要があります。モニターのサイズと解像度によって異なります。
1つの画面に収まる場合は、メソッドと関数が最適です。
ファイルは長すぎてはいけません。最良のものは、クラスと実装が理解しやすい短いファイルです。
かつて、10 klinesファイルのプロジェクトに取り組みました。とても複雑な本を読むようなものでした。実装によって発生した問題の数を通知する必要がありますか?
80文字!
私がCOBOLを行ったとき、私は約80 ページ以上の課金プログラムのソースコードファイルを見ていました。もちろん、これが一般的な慣習に近いことはわかりませんが、80文字も同様にばかげています。
クラスサイズビューから、この提案を約80のプロパティと20ほどのメソッドを持つ一般的なCustomerクラスに適用しようとすると、クラスを他のいくつかのクラスに分割し、コードを非常に乱雑にする必要があります。
クラスとメソッドは短く保つようにしていますが、行の長さについてはあまり気にしないでください。ワイドスクリーンと長い識別子の最近の時代では、80文字は少なすぎると思います。ステートメントを簡単に読み取れるように分割するにはいくつかの作業が必要です。80文字の制限があるため、頻繁に発生します。1行あたり約120列または130列の方が妥当だと思います。