Pourquoi les importations relatives dans Python 3 échouent-elles et comment puis-je les corriger ?

Importations relatives dans Python 3 : les erreurs mystérieuses

Dans Python 3, les importations relatives sont un moyen pratique d'importer des modules à partir du même annuaire. Cependant, une erreur inattendue survient souvent :

Messages d'erreur :

• ImportError : tentative d'importation relative sans package parent connu
• ModuleNotFoundError : Aucun module nommé 'mymodule'
• SystemError : module parent '' non chargé, impossible d'effectuer une importation relative

La cause profonde :

Pour comprendre ces erreurs, nous devons nous plonger dans le mécanisme d'importation de modules de Python. Les importations relatives nécessitent que le module d'importation soit contenu dans un package. Un package est un répertoire marqué comme package par la présence d'un fichier __init__.py.

Mise en page commune :

Souvent, les packages ont la structure suivante :

main.py
mypackage/
    __init__.py
    mymodule.py
    myothermodule.py

Exemple Code :

• monmodule.py

# Exported function
def as_int(a):
    return int(a)

# Test function for module  
def _test():
    assert as_int('1') == 1

if __name__ == '__main__':
    _test()

• monautremodule.py

# Exported function
def add(a, b):
    return as_int(a) + as_int(b)

# Test function for module  
def _test():
    assert add('1', '1') == 2

if __name__ == '__main__':
    _test()

• main.py

from mypackage.myothermodule import add

def main():
    print(add('1', '1'))

if __name__ == '__main__':
    main()

Lorsque vous exécutez main.py ou mypackage/mymodule.py, tout fonctionne bien. Cependant, l'exécution de mypackage/myothermodule.py échoue en raison de l'importation relative :

from .mymodule import as_int

La solution :

Comme l'explique Guido van Rossum, cet échec est dû à Python traite les scripts en cours d'exécution à partir d'un package comme un anti-modèle. La solution recommandée est d'éviter les importations relatives et d'utiliser plutôt les importations absolues :

from mypackage.mymodule import as_int

Approches alternatives :

Si vous préférez toujours les importations relatives, vous pouvez utiliser le - m pour spécifier le module à importer, mais cela peut être verbeux et peu pratique :

python3 -m mypackage.myothermodule

Une autre alternative consiste à manipuler PYTHONPATH pour inclure le répertoire parent du package :

import sys
import os

SCRIPT_DIR = os.path.dirname(os.path.abspath(__file__))
sys.path.append(os.path.dirname(SCRIPT_DIR))

from mypackage.mymodule import as_int

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!