Python 3.8+下兄弟目录模块导入链问题求助

问题核心 #

module1.py中使用from module2 import *这种同级模块导入方式，单独运行时没问题，但当从其他子目录（如subdir2的module3）导入module1时，Python的模块搜索路径无法定位到module2——此时module1是作为subdir1包的一部分被导入，而非独立运行的脚本。

可行解决方案 #

方案1：改用相对导入 #

修改module1.py的导入语句为相对导入，确保无论module1是被外部导入还是单独运行，都能正确找到同级的module2：

# module1.py
from .module2 import *

之后在module3.py中直接通过包路径导入即可，无需手动添加sys.path（已通过pip install .安装包）：

# module3.py
from subdir1.module1 import *

若需单独运行module1.py，需以包的方式启动，在main_dir目录下执行：

python -m subdir1.module1

方案2：基于包的绝对导入（更适配扩展） #

既然已通过setup.py将项目作为包安装，可采用包名+子目录的绝对导入方式修改module1.py：

# module1.py
from subdir1.module2 import *

这种方式下，无论是单独运行module1（同样用python -m subdir1.module1启动），还是从module3导入，都能正常识别module2。module3.py的导入语句与方案1一致：

# module3.py
from subdir1.module1 import *

注意事项 #

• 不要在代码中使用sys.path.append('..')，这种硬编码路径会破坏包结构，影响后续扩展。
• 所有__init__.py保持空即可，setuptools已能识别包结构。
• 每次修改代码后，在main_dir目录下重新执行pip install .；若用开发模式安装（pip install -e .），修改代码后无需重新安装。

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