子包内绝对导入可行性及Git subtree引入后的导入适配疑问

首先得搞清楚问题根源：当repo1作为subtree被嵌入repo2后，subpackage的层级变了——原来它是顶级包（直接在repo1根目录下），现在它的父包变成了repo1。Python的绝对导入是基于sys.path里的路径来查找包的，原来的from subpackage.module2 import...会在sys.path的顶级目录里找subpackage，但现在它藏在repo1下面，自然找不到了。

下面是几种可行的解决办法：

1. 改用相对导入（最推荐） #

这是Python官方推荐的子包内部模块间导入的方式，完全不依赖外部目录结构，让subpackage本身更独立。修改module1.py的导入语句：

# module1.py
from .module2 import my_function

这里的.代表当前包目录，不管subpackage被放到哪个父项目里，都能正确找到同目录的module2。

2. 把repo1添加到sys.path #

如果你想保留原来的绝对导入语句，可以在代码运行时把repo1的路径加入Python的搜索路径。比如在repo2的main.py开头添加：

import os
import sys
sys.path.append(os.path.abspath(os.path.join(os.path.dirname(__file__), "repo1")))

或者在repo1/subpackage/__init__.py里添加类似的路径处理，确保subpackage所在的目录被加入sys.path。这样原来的from subpackage.module2 import...就能正常工作了。

不过这种方式需要注意路径的动态获取，别用硬编码的路径，否则换个环境可能失效。

3. 使用完整的绝对导入路径 #

修改module1.py的导入语句为基于repo2的完整路径：

# module1.py
from repo1.subpackage.module2 import my_function

但这种方式的缺点很明显：repo1必须以这个名字存在于父项目中，如果以后repo1被重命名或者放到其他层级，又会出现导入错误，灵活性很差。

总结一下：不是必须改用相对导入，但相对导入是最稳健、最灵活的方案，能让你的subpackage在任何父项目中都正常工作。如果实在想保留原有的绝对导入风格，添加sys.path的方式也能解决问题。

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