面试提交的Python项目本地测试正常，评审端遇模块导入问题求助

嘿，我之前也踩过一模一样的坑！本地在PyCharm、Spyder、Jupyter里跑啥问题没有，一到端侧就直接报模块找不到——核心原因就是IDE悄悄帮你处理了模块搜索路径，但端侧环境没这个自动配置。你的my_package/my_submodule_1.py里用import my_module，本地IDE会自动把my_project/根目录加到Python的sys.path（模块搜索路径）里，但端侧环境大概率没这么做，所以找不到上层的my_module文件。

下面给你几个实用的解决办法，按靠谱程度排序：

1. 用相对导入（最符合Python包规范） #

直接把my_submodule_1.py里的导入语句改成相对路径形式：

from .. import my_module

⚠️ 注意：这种方式要求你必须把项目当成一个完整的包来运行，不能直接单独执行my_submodule_1.py（比如敲python my_package/my_submodule_1.py会报错）。正确的启动方式是从my_project/根目录出发，运行python main_module.py或者python -m main_module，这样Python才能正确识别包的层级结构。

2. 手动把根目录塞进sys.path（兼容性拉满） #

如果相对导入对你的场景不太适用，就在my_submodule_1.py的开头加几行代码，强制让Python找到项目根目录：

import sys
import os
# 拿到当前文件所在目录的上层目录（也就是my_project/）
project_root = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
# 如果根目录不在搜索路径里，就添加进去
if project_root not in sys.path:
    sys.path.append(project_root)

# 现在再导入my_module就没问题了
import my_module

这种方式不管端侧环境怎么配置都能正常运行，唯一的小缺点是硬编码了路径逻辑，但只要你的项目结构不变就稳得一批。

3. 设置PYTHONPATH环境变量（适合部署场景） #

如果不想修改代码，可以在端侧启动项目前，先把项目根目录配置到PYTHONPATH环境变量里：

• Windows命令行：

  set PYTHONPATH=C:\你的项目路径\my_project
  python main_module.py
  

• Mac/Linux终端：

  export PYTHONPATH=/你的项目路径/my_project
  python main_module.py
  

这种方式适合部署时统一配置，不用动代码，但要确保端侧的启动脚本里包含这个环境变量的设置。

验证方法 #

修改后可以在端侧快速验证：

1. 进入my_project/根目录
2. 运行python main_module.py（如果main_module.py是项目入口）
3. 或者用python -m my_package.my_submodule_1测试子模块的导入逻辑

要是还是有问题，就在代码里打印一下sys.path看看根目录有没有被正确添加：

import sys
print(sys.path)

一眼就能定位路径问题出在哪！

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