Pythonで「import *」（ワイルドカードインポート）が悪い考えである理由

Pythonでは、from sample import * のようにモジュールからすべてのメソッドを一括でインポートする「ワイルドカードインポート」は避けるべきとされています。その主な理由は以下の2点です。

• プログラム内で使用したメソッドが、どのモジュール（親モジュール）から来たのかを特定するのが難しくなる。
• インポートされたメソッドと同じ名前の関数を自由に定義できなくなり、名前の衝突が発生しやすい。

具体例

まず、sample.py というファイルに add という関数を定義してみましょう。

## sample.py ファイル
def add(a, b):
    return a + b

このファイルを、次のPythonファイルと同じディレクトリに保存します。

## sample というモジュールがあると仮定します
from sample import *

def add(*nums):
    return sum(nums)

print(add(1, 2, 3, 4, 5))

実行結果

上記のプログラムを実行すると、次の出力が得られます。

15

sample パッケージ内にも同じ名前の add メソッドが存在する場合、大規模なプログラムでは実際にどちらの関数が呼び出されたのかを特定するのが非常に困難になります。さらに、引数の違いによって予期しないエラーが発生する可能性もあります。

明示的にインポートする方法

先ほどのプログラムでは、sample パッケージのメソッドではなく、ローカルに定義した関数が優先的に呼び出されました。もし sample パッケージ側のメソッドを確実に呼び出したい場合は、以下のようにモジュール全体をインポートし、モジュール名を明示して呼び出す必要があります。

## sample というモジュールがあると仮定します
import sample

def add(*nums):
    return sum(nums)

print(sample.add(1, 2))

実行結果

上記のプログラムを実行すると、次の出力が得られます。

3

まとめ

Pythonではモジュールを自由にインポートできますが、大規模なプログラムになると、インポートしたメソッド名とユーザー定義関数の名前が混同されやすくなります。名前の管理に十分な自信がある場合を除き、ワイルドカードインポートは避け、必要な要素だけを明示的にインポートするか、モジュール名を付けて呼び出すのが安全で可読性の高いコードにつながります。