Pythonプログラミングでよくある落とし穴6選 ― 初心者〜上級者がハマりやすいポイントを実例付きで解説

Pythonは書きやすく柔軟な言語ですが、その柔軟さゆえに、経験豊富な開発者でも陥りやすい「落とし穴」がいくつか存在します。ここでは、Pythonプログラミングで特によく見られるミスや注意点を、具体例とともに解説します。

1. スコープと名前解決（LEGBルール）

Pythonは変数名を LEGB（Local → Enclosing → Global → Built-in） の順序で探索します。Pythonには厳密な型束縛がないため、外側のスコープにある変数に別の値を再代入できてしまいます。その結果、後から外側のスコープでその変数を使おうとしたときに、意図しない値に入れ替わっていることがあるのです。

2. is と == の混同

is 演算子は、2つのオブジェクトが同じメモリアドレス（同一オブジェクト）を参照しているかどうかを判定します。一方、== 演算子は __eq__ メソッドを呼び出します。このメソッドはクラスごとに異なる実装が可能なため、「等しい」の意味がクラスによって変わります。値の比較には == を、同一性の確認には is を使うのが基本です。

3. リストの反復処理中の変更

forループなどでリストを反復処理している最中に要素を削除すると、IndexError が発生することがあります。これは、リストのサイズが縮小しているのに、インデックスがそれに追いつかないために起こる現象です。反復中の変更は避け、必要であればリストのコピーを反復するか、リスト内包表記で新しいリストを作成するのが安全です。

4. クロージャによる遅延バインディング

次のコードを見てください。

例

listLambdas = [lambda x : i + x for i in range(5)]
for lam in listLambdas:
    print(lam(10))

出力

14
14
14
14
14

驚いたでしょうか？ 各ラムダ式は 0, 1, 2, 3, 4 を加算するように見えますが、実際にはすべて「14」を出力します。これはクロージャの遅延バインディング（late binding）が原因です。リスト内のすべてのラムダ式は同じ変数 i への参照を保持しており、呼び出し時点での i の値（ループ終了後は4）を使用するためです。

5. 組み込み関数・組み込み名との衝突

sum や list といった名前の変数を作ったことはありませんか？ その瞬間、組み込み関数への参照を上書きしてしまっています。単純な例では些細な問題に思えますが、パッケージやモジュールをこのような名前にすると深刻な問題を引き起こす可能性があります。他のパッケージが標準ライブラリではなく、あなたのクラスやモジュールを誤ってインポートしてしまうこともあり得ます。

6. 演算子オーバーロードの直感に反する実装

Pythonではクラスに対して演算子をオーバーロードできます。しかし、この機能を一般的な意味とは異なる方法で実装してしまうと、複雑で直感的に使えないAPIになってしまうことがよくあります。+ や - などの演算子を実装する際は、利用者が自然に予想できる動作にすることを心がけましょう。

これらの落とし穴をあらかじめ理解しておくことで、デバッグにかかる時間を大幅に削減し、より堅牢で読みやすいPythonコードを書けるようになります。