如何让本地Python代码保留main前缀导入路径正常运行？

当你在main文件夹下直接运行test.py，用from main.configs.conf import LOC出现模块找不到的错误，本质是Python的模块搜索路径没包含main的父目录，导致无法识别main作为顶层模块。以下是几种能保留main前缀导入的解决办法：

方法一：在脚本中动态添加路径 #

在test.py的最开头加入这段代码，把main的上级目录添加到Python的搜索路径中：

import sys
import os
# 获取当前脚本的绝对路径，再向上取一级得到main的父目录
sys.path.append(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))

之后再执行from main.configs.conf import LOC就能正常导入。

方法二：用-m参数运行脚本 #

切换到main的父目录下，用Python的模块运行方式执行test.py：

python -m main.test

这种方式会把当前目录作为顶层模块的搜索根路径，Python就能正确识别main模块及其子模块。

方法三：设置PYTHONPATH环境变量 #

把main的父目录添加到系统的PYTHONPATH环境变量中，让Python全局识别这个路径：

• Linux/macOS终端：

export PYTHONPATH="/your/main/parent/directory:$PYTHONPATH"

• Windows命令提示符：

set PYTHONPATH=C:\your\main\parent\directory;%PYTHONPATH%

设置完成后，直接运行test.py即可正常使用带main前缀的导入语句。

生产和开发环境之所以能正常运行，大概率是因为这些环境已经通过部署配置、包安装等方式，把项目根目录（main的父目录）加入了Python的模块搜索路径，所以main能被识别为顶层模块。

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