Pythonでの変数命名の規約は、公式スタイルガイド「PEP8」に準拠するのが基本です。

Pythonでの変数命名の規約は、公式スタイルガイド「PEP8」に準拠するのが基本です。以下に、主要なルールとおすすめの命名パターンをまとめます:


🧠 基本ルール(PEP8に基づく)

ルール説明
小文字+アンダースコア通常の変数user_name, total_price
大文字定数MAX_RETRIES, PI
単語はアンダースコアで区切る可読性を高めるfile_path, user_input
わかりやすい名前にするa, bなどは避ける(短命変数以外)count, email_list

🧩 命名パターン(種類ごとの命名)

用途命名パターン
通常の変数snake_caseuser_id, file_size
定数UPPER_SNAKE_CASEMAX_SIZE, API_KEY
クラス名PascalCaseUserModel, ImageProcessor
インスタンス変数self.variable(snake_case)self.user_name
プライベート変数_variable_cache, _temp_list
非公開・強制非公開変数__variable__secret_key

❗避けるべき命名

パターン理由
1文字(l, O, I1, 0 と見間違いやすい
意味のない名前(tmp, data, thingコードの意味が分かりづらい
Java風のキャメルケース(camelCasePythonでは推奨されない

🛠 便利なチェックツール

  • flake8:PEP8違反をチェックできるLintツール
  • black:自動整形ツール(変数名は対象外だけど、スタイル全般を整える)

必要であれば、変数名を自動的にリファクタリングするスクリプトや、命名例のテンプレートも作れます!欲しければ言ってくださいね。

よかったらシェアしてね!
目次