Python不同路径运行脚本时跨目录导入失效解决方案

问题复现 #

初始目录结构：

A--Ab
   |
   |--Abc--main.py
   |  
   |--Abd--*.py
   |
   Ac--*.py

所有层级目录均已放置__init__.py文件。最初在Abc目录下的main.py中添加如下路径配置：

sys.path.insert(0, os.path.abspath("../../.."))

在Abc目录内直接运行python main.py时导入正常，但切换到Ab目录执行python Abc/main.py时导入逻辑失效。

后续更新目录结构为：

A--Ab
   |-config.py
   |-main.py 
   |-*.py

需要实现：无论在哪个目录执行脚本，模块导入都能正常生效。 #

失效原因 #

os.path.abspath()解析相对路径时，参考基准是执行命令时终端的当前工作目录，而非main.py文件自身的存储位置。工作目录会随你执行命令的位置变化而变化，因此相对路径解析出的结果不固定，一旦切换执行位置就会出现路径错误。 #

修复方案 #

核心逻辑：抛弃基于工作目录的相对路径写法，基于脚本文件自身的固定绝对路径推导项目根目录，再将根目录加入导入路径。

具体代码实现 #

在入口脚本（main.py）最开头添加如下代码，根据自己的目录层级调整向上回溯的层数即可：

import sys
import os

# 获取当前入口脚本的绝对路径
current_script = os.path.abspath(__file__)

# 向上回溯目录，直到拿到项目根目录A的路径
# 例1：main.py在Ab/Abc/路径下（初始结构），需要向上回溯3层：
# project_root = os.path.dirname(os.path.dirname(os.path.dirname(current_script)))
# 例2：main.py在Ab/路径下（更新后结构），需要向上回溯2层：
project_root = os.path.dirname(os.path.dirname(current_script))

# 将固定的项目根目录加入系统导入路径
sys.path.insert(0, project_root)

后续所有模块导入统一使用从项目根目录开始的绝对导入写法，例如：

# 导入Ab下的config模块
from Ab import config
# 导入Ac下的模块
from Ac import some_module
# 导入Abd下的模块
from Ab.Abd import other_module

优化建议 #

• 运行脚本优先使用模块启动方式：在项目根目录下执行python -m Ab.main（更新后结构）或python -m Ab.Abc.main（初始结构），这种方式会自动将当前工作目录加入导入路径，比直接传入文件路径运行更符合Python模块规范，能减少大量路径问题。
• 如果项目需要长期维护，推荐在项目根目录编写pyproject.toml配置文件，在项目根目录执行pip install -e .将项目以可编辑模式安装到当前Python环境，后续完全不需要手动修改sys.path，所有位置都能正常导入项目内模块。

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