最上位パッケージを超えた相対インポート

マルチレベル Python パッケージ内で相対インポートを試行する場合、パッケージ ディレクトリからモジュールを実行します「ValueError: 最上位パッケージを超えた相対インポートを試行しました」エラーが発生する可能性があります。このエラーの背後にある理由を理解することは、効果的なパッケージ管理にとって非常に重要です。

このエラーは、Python がパッケージのロード元の記録を保持していないために発生します。 「python -m test_A.test」としてモジュールを実行すると、基本的に、test_A.test がパッケージ内にないことが (package/test_A に存在するにもかかわらず) Python に通知されます。その結果、Python には test_A がより大きなパッケージの一部であるという知識がないため、「from ..A import foo」の試行は無効になります。

対照的に、「python -m package.test_A.test」を使用すると、階層構造が保持されます。これにより、「from ..A import foo」が正常に解決されます。これは、test_A がロードされたパッケージ "package" 内の子ディレクトリであるという事実を正確に反映しています。

Python が現在の作業ディレクトリをパッケージと見なさない根本的な理由は不明です。ただし、この制限は、「__init__.py」ファイルを使用してディレクトリをパッケージとして明示的に宣言し、モジュールをインポートするときに Python のパッケージ検索メカニズムに従うことで軽減できます。