如何在Python项目全局范围内从不同文件夹导入文件？

嘿，我太懂你这种纠结了——不想动系统级的PYTHONPATH搞乱全局环境，又嫌打包成正式Python包太麻烦（还要处理pyc编译、包结构这些琐事），就想要个只针对当前项目生效的轻量化方案对吧？

下面两个方法完全符合你的需求，而且实现起来超简单：

方法1：用项目启动入口脚本统一设置sys.path #

这是最直观也最可控的方式，本质是在项目启动时临时把需要的目录加入Python的搜索路径，而且只对当前项目的运行会话生效。

举个例子，假设你的项目结构是这样的：

my_project/
├── src/
│   ├── main.py  # 你的主业务代码
│   └── utils/
│       └── helper.py
└── external/
    └── tools/
        └── data_processor.py  # 你想跨文件夹导入的文件

你只需要在项目根目录创建一个run.py作为统一启动入口，内容如下：

import sys
from pathlib import Path

# 获取项目根目录的绝对路径（不管你从哪里启动脚本都能正确识别）
PROJECT_ROOT = Path(__file__).resolve().parent

# 把需要导入的额外目录添加到sys.path
sys.path.append(str(PROJECT_ROOT / "external/tools"))
sys.path.append(str(PROJECT_ROOT / "src/utils"))

# 启动你的主程序
from src.main import main
if __name__ == "__main__":
    main()

之后你所有的运行都通过python run.py来启动，这样项目里的所有文件都能直接导入data_processor或者helper，完全不需要在每个文件里单独修改导入路径。而且这个修改只在当前项目的运行会话里生效，不会影响其他Python项目。

方法2：用项目内的.pth文件配合启动脚本（更优雅的路径管理） #

如果你觉得在启动脚本里写一堆sys.path.append不够整洁，可以用Python的.pth文件来管理路径：

1. 在项目根目录创建一个project_paths.pth文件，把需要添加的目录一行一个写进去（支持相对路径）：

./external/tools
./src/utils

2. 修改刚才的run.py，用site.addsitedir来加载这个.pth文件：

import site
from pathlib import Path

PROJECT_ROOT = Path(__file__).resolve().parent
# 加载项目内的.pth文件，自动把里面的目录加入sys.path
site.addsitedir(str(PROJECT_ROOT))

from src.main import main
if __name__ == "__main__":
    main()

这种方式的好处是，后续需要添加新的导入目录时，直接修改.pth文件就行，不用动启动脚本的代码，管理起来更清晰。

为什么这两个方法适合你？ #

• 项目级隔离：完全不会修改系统或全局的PYTHONPATH，只对当前项目生效；
• 无需打包：不用折腾setup.py、包结构、pyc编译这些，修改代码后直接运行就能生效；
• 全局生效：只要通过统一的启动脚本运行，项目里所有文件都能享受到路径设置，不用在每个文件里单独处理导入问题。

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