如何避免主脚本调用模块时需修改子模块导入路径的问题

方法1：配置PYTHONPATH环境变量 #

将Project根目录添加到PYTHONPATH，让Python能识别Scripts下的子模块：

• Windows命令行：

set PYTHONPATH=你的Project绝对路径
python Scripts\module.py

• Linux/macOS终端：

export PYTHONPATH=/你的Project绝对路径
python Scripts/module.py

方法2：使用-m参数运行模块 #

在Project根目录下执行命令：

python -m Scripts.module

-m参数会将当前目录（Project根）加入sys.path，把Scripts当作包加载，既可以执行module.py的主函数逻辑，又能保证导入路径和main.py运行时一致。

统一规范建议 #

要求开发人员遵循以下任一方式运行单个模块文件：

1. 始终在Project根目录下，用python -m Scripts.xxx的形式执行模块
2. 提前配置PYTHONPATH指向Project根目录，再直接运行模块脚本

这样就能在不修改代码的前提下，让main.py和单个模块文件的运行都保持导入路径一致。

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