Python 変数名の長さについて

Question

初心者丸出しの質問で申し訳ございません。

変数名の長さはどの程度が理想なのでしょうか？
特に、アンダーバーの数や何文字以内に収めるべきかなど

PEP8などをざっと見ても一行の長さに関する記述はあっても、変数名の長さに関しては無かったようなので質問させていただきました。

もし個人的なマイルールなどがあればそれもぜひお聞きしたいです。

Answer 1

変数名の策定においては「その名前が説明的で、名前を見ただけで何をするための変数なのかが一目瞭然で分かる」のが好ましいと思います。

その観点から見て、変数名の長さは絶対優先事項ではないと思います。とはいえ、あまりにも長すぎると入力するのも目視するのも大変です。

私がその辺のバランスを取ろうと試行錯誤を続けた結果何となく実践しているのは、

• ポピュラーに使われる略号などがあれば使う。例：compare→cmp、check→chkなど。
• ある限定的な場所で限られた回数しか参照しない変数は分かりやすさ最優先で「長い名前」を躊躇せず採用。その逆のケースでは積極的に短い変数名を採用。

プログラミング教本などにある「適切な変数名の付け方」的なものを何度か読んで真似しようとしたことはありますが、私の場合はあまり習慣として定着しませんでしたね。

Answer 2

• 既存のプログラムの修正をするなら

型を意識した接頭語や接尾語、短縮の仕方などを含めて既存のコードと同じように変数名をつけましょう。

• 新規プログラムをチームで開発するなら

コーディング規約を決めましょう。
コーディング量が多くなければ、決定者を一人決めてその人の意見で決めましょう。

• 個人で開発して、他の人に提供するなら

長めでもわかりやすい変数名を使いましょう。

• 個人で開発して、自分が長く使うなら

1年後に自分が読んで理解できるような変数名を使いましょう。

• 個人で開発して、一回しか使わないなら

変数名を気にする必要はありません。

Answer 3

個人的に変数の絶対的な文字数上限は特に気にしていません。

コードを書いたり読んだりする上で常識的な長さ、としかいいようがないです。

長さを気にするよりも、名前そのものがわかりやすいことが大事だと思います。
たとえば、リーダブル・コードという本に、どのような名前をつけるべきか？ということが書かれてあります。

今やIDEで変数は自動的に補完入力することも可能なので、長さにとらわれて意味が分からないような省略形を使うくらいなら、無理に短くする必要はないと思います。

（もちろん一時的なローカル変数など間違うリスクがないならば単純な短い変数名でもいいと思います。要は目的と使い分け）

Answer 4

4から12文字ぐらいがいいです。
短くて意味がわかるほうがいいと思います。