python-expert-best-practices-code-review

Python 3.14+ のベストプラクティス

シンプルで実践的、かつ明確な方針に基づいています。本番品質の Python コードを書くうえで重要なことだけを扱います。

適用する場面

次のような場面で、これらのガイドラインを参照してください。

• Python の関数、クラス、モジュールを作成するとき
• エラー処理に問題がないか Python コードをレビューするとき
• 既存の Python コードベースをリファクタリングするとき
• データ検証と API の境界を実装するとき
• エラー検出とデバッグのパターンを最適化するとき

優先度別のルールカテゴリ

優先度	カテゴリ	影響度	プレフィックス
1	エラー処理	重大	dict-, operators-
2	よくあるバグ	重大〜高	no-mutable-, no-generic-
3	コードの明瞭さ	高〜中	listcomp-, no-inline-
4	コードスタイル	低	avoid-, unnecessary-

クイックリファレンス

• dict-required-keys - 必須の辞書キーには d[key] を使い、KeyError をすばやく発生させます
• no-mutable-defaults - 関数やメソッドの引数に可変のデフォルト値を使いません
• operators-return-notimplemented - サポートされていないオペランド型には NotImplemented を返し、+ と += の動作を意図的に設計します
• no-generic-except - 予期しないエラーを隠さないよう、汎用的な except 節を避けます
• listcomp-no-side-effects - リスト内包表記では、使用する値を生成する必要があります（副作用だけを目的としたリスト内包表記は使いません）
• no-inline-imports - すべての import 文をファイルの先頭に配置します
• avoid-explanatory-comments - 自己説明的なコードには不要なコメントを避けます
• unnecessary-else-blocks - return、break、continue 文の後に不要な else ブロックを置きません

使用方法

詳しい説明とコード例については、各ルールファイルを参照してください。

rules/dict-required-keys.md
rules/no-mutable-defaults.md
rules/operators-return-notimplemented.md
rules/no-generic-except.md
rules/listcomp-no-side-effects.md
rules/no-inline-imports.md
rules/avoid-explanatory-comments.md
rules/unnecessary-else-blocks.md

各ルールファイルには、次の内容が含まれています。

• 重要である理由の簡潔な説明
• このパターンを使う場合と使わない場合
• 実装要件
• 説明付きの誤ったコード例
• 説明付きの正しいコード例
• 追加の背景情報と参考資料