Python引入公共constants模块导致循环导入问题求解

该循环导入的核心触发逻辑如下：

1. 命名冲突导致模块匹配错误：你的项目中存在与包同名的入口脚本pycircular.py，当foo.py执行from pycircular.constants import ANOTHER_CONSTANT时，Python导入机制没有匹配到外层的同名包，反而匹配到了同目录下的pycircular.py脚本，触发该脚本的二次执行。
2. 循环依赖链形成：直接运行pycircular.py时，脚本作为__main__模块执行，先导入my_classes.foo的Foo类；进入foo.py后导入pycircular.constants，触发pycircular.py的二次加载；二次加载的pycircular.py执行到导入Foo的语句时，foo模块还处于初始化阶段，尚未完成Foo类的定义，直接抛出导入错误。
3. 重命名包后恢复正常的原因：将包名改为pycircular_pack后，foo.py导入pycircular_pack.constants不会再和入口脚本pycircular.py重名，导入路径匹配正确，不会触发入口脚本的二次执行。PyCharm的Add content roots to PYTHONPATH选项生效时，外层项目目录会被加入模块搜索路径，也会优先匹配到完整的包结构，规避模块匹配错误的问题。

• 调整导入语句：直接在foo.py中使用from constants import ANOTHER_CONSTANT导入，不需要带包名前缀，规避错误的模块匹配，适合小型项目快速修复。
• 消除命名冲突：将入口脚本pycircular.py重命名为main.py，或者将入口脚本挪到包的外层目录，从根源上避免入口脚本和包名重名的问题，后续导入不会再出现匹配错误。
• 使用延迟导入：将pycircular.py中Foo的导入逻辑挪到main函数内部：

  from constants import SOME_CONSTANT
  
  def main():
      from my_classes.foo import Foo
      print(SOME_CONSTANT)
      my_foo = Foo()
      my_foo.do_something()
  

  只有在实际执行业务逻辑时才会导入Foo，不会在pycircular.py被二次加载时触发导入逻辑，避免循环依赖。
• 使用相对导入：在包内模块foo.py中使用相对导入引用同包资源：

  from ..constants import ANOTHER_CONSTANT
  

  导入路径直接和文件结构绑定，不会触发错误的模块匹配。

内容的提问来源于stack exchange，提问作者gillesB