Python项目：如何从顶层非包目录导入脚本中的类？

我来给你几个不用移动config.py就能解决的可行方案：

方案1：动态添加项目根目录到sys.path #

直接运行package/module.py时，Python的模块搜索路径（sys.path）里只有package/目录，所以找不到顶层的config.py。你可以在module.py开头添加一段代码，把项目根目录（main_project/）加入到搜索路径中：

import sys
from pathlib import Path

# 定位到项目顶层目录：当前文件的父目录的父目录
project_root = Path(__file__).resolve().parent.parent
sys.path.append(str(project_root))

# 现在就能正常导入Config类了
from config import Config

这里用Path.resolve()是为了处理符号链接的情况，确保路径绝对正确，不管你从哪个目录运行module.py都能精准找到项目根目录。

方案2：从项目顶层以模块方式运行（推荐） #

这是更符合Python包规范的做法，别直接运行module.py，先切换到main_project/目录下，再用以下命令运行：

python -m package.module

这种运行方式下，Python会自动把main_project/加入到sys.path中，此时你在module.py里直接写from config import Config就不会触发导入错误了。

补充：为什么直接运行会报错？ #

简单来说，Python的模块搜索路径是由你启动脚本的位置决定的：

• 直接运行package/module.py时，package/会被加入sys.path，顶层的main_project/不在搜索范围内，自然找不到config.py
• 用python -m package.module运行时，启动目录是main_project/，这个目录会被自动加入sys.path，所以能正常找到config.py

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