Python项目子目录结构规划及跨目录代码调用方法咨询

我来帮你搞定这个Python项目结构和跨目录调用的问题——你遇到的相对导入报错，核心原因是直接运行脚本时，Python不会自动把项目根目录识别成包结构的一部分，咱们一步步拆解解决：

一、先理清楚合理的项目子目录规划 #

你的现有结构其实已经很规范了，再微调下更顺手：

• root/：作为项目顶级包，必须放一个空的__init__.py，告诉Python这是一个可导入的包
• root/foo/：核心功能模块目录，同样放__init__.py，可以在这个文件里提前导出foo.py里的核心内容，比如from .foo import FooClass，这样外部调用时不用写深层路径
• root/test/：测试代码目录，每个功能模块对应一个测试文件（比如foo_test.py对应foo/foo.py），也建议加__init__.py，方便用测试框架统一管理

二、解决你遇到的相对导入报错问题 #

你用from ... import foo报错，本质是直接运行foo_test.py时，Python把test/当成了顶层模块，而不是root包的子目录，导致相对导入的层级完全乱了。这里给你两种实用的解决方法：

方法1：手动添加根目录到Python路径，用绝对导入 #

修改foo_test.py，先把项目根目录加入Python的搜索路径，再用绝对导入调用模块：

#!/usr/bin/python
import sys
import os

# 获取项目根目录的绝对路径（当前脚本在test/，往上跳一级就是root）
root_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(root_dir)

# 现在可以直接用绝对导入了，比如导入foo.py里的Foo类
from foo.foo import Foo

修改后直接运行./test/foo_test.py或者python test/foo_test.py就没问题了。

方法2：用-m参数以模块方式运行（推荐） #

这种方法不需要改代码，只要从项目根目录下执行命令就行：
先切换到root/目录，然后运行：

python -m test.foo_test

此时Python会把root识别为顶级包，你就可以在foo_test.py里用正确的相对导入：

#!/usr/bin/python
# 从test的上一级（也就是root）导入foo模块
from ..foo import foo

注意这里用的是..而不是...——因为test和foo都是root的直接子目录，往上一级就到root了，层级别写多了。

三、额外的优化小建议 #

• 可以在root/下加个pyproject.toml（或者旧版的setup.py），把项目做成可安装的包，安装后直接import foo就能用，完全不用管路径问题
• 测试用pytest框架的话，直接在root/下敲pytest就能自动跑所有测试用例，比手动运行脚本方便多了
• 尽量避免在包内部直接运行脚本，用-m参数以模块方式运行，能避开绝大多数路径坑

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