Python项目同名文件导入路径错误问题及解决咨询

针对你遇到的导入问题，这里有几个实用的解决办法：

1. 统一以项目根目录作为工作目录运行 #

不管你是运行顶层的main.py，还是要单独运行HelloWorld下的脚本，都切换到Test目录（项目根目录），然后用模块方式运行：

• 运行main.py：python main.py
• 单独运行b.py：python -m HelloWorld.b

这种方式下，Python会自动把项目根目录加入模块搜索路径，b.py里的from .a import stuff相对导入就能在两种场景下都正常工作。

2. 手动修改模块搜索路径 #

在HelloWorld/b.py的开头添加以下代码，把当前脚本所在的目录（也就是HelloWorld目录）加入Python的模块搜索路径最前面：

import sys
import os
# 获取当前脚本所在目录的绝对路径
current_dir = os.path.dirname(os.path.abspath(__file__))
# 把该目录加入搜索路径的最前面，确保优先搜索同目录的模块
sys.path.insert(0, current_dir)

之后b.py里直接用import a就能导入同目录的a.py，不管你在哪个目录运行脚本都能生效。

3. 使用绝对导入替代相对导入 #

把b.py里的导入语句改成绝对路径形式：

from HelloWorld.a import stuff

这种方式需要确保Test目录在Python的模块搜索路径中。如果直接在HelloWorld目录运行脚本，可能需要手动把Test目录加入sys.path，或者在运行时指定：

# 在HelloWorld目录下运行时，把上级目录加入搜索路径
python -c "import sys; sys.path.insert(0, '..'); import HelloWorld.b"

或者你可以把Test目录安装为可编辑包（在Test目录执行pip install -e .），这样系统会自动识别HelloWorld作为顶级包。

内容的提问来源于stack exchange，提问作者K-D-G