Python脚本在一台机器正常运行，另一台模块导入失败求助

可能的原因 #

• Python环境差异：两台机器使用的Python解释器不属于同一环境（比如一台是系统全局Python，另一台是虚拟环境），默认sys.path配置不同，导致其中一台无法识别顶层包目录。
• 共享路径挂载不一致：虽然是共享存储，但两台机器挂载该目录的绝对路径不同，你手动插入sys.path时用的路径只适配了其中一台，另一台路径不匹配。
• 执行脚本的工作目录不同：比如一台在my_repo根目录下执行python installations/my_install_script.py，另一台进入installations目录执行python my_install_script.py，这会导致Python识别包的根目录逻辑不同。
• init.py 文件缺失：尽管Python 3.3+支持无__init__.py的命名空间包，但部分旧环境或特殊配置下，缺少顶层目录的__init__.py可能导致包识别失败。

对应的解决办法 #

1. 统一执行脚本的工作目录 #

无论在哪台机器，先切换到my_repo根目录，再执行脚本：

cd /path/to/my_repo
python installations/my_install_script.py

这样Python会自动将当前工作目录（my_repo）加入sys.path，就能正确识别topology、utils这些顶层包。

2. 自动适配的sys.path设置 #

如果必须在其他目录执行脚本，让脚本自动获取my_repo根目录并加入路径，避免手动写死路径的问题。在my_install_script.py最开头添加：

import os
import sys
# 获取当前脚本所在目录，向上退一级就是my_repo根目录
script_dir = os.path.dirname(os.path.abspath(__file__))
repo_root = os.path.dirname(script_dir)
sys.path.insert(0, repo_root)

3. 检查Python环境一致性 #

对比两台机器的Python环境：

• 执行which python（Linux/macOS）或where python（Windows），确认是否使用同一解释器。
• 执行python -c "import sys; print(sys.path)"，对比两台机器的sys.path输出，看my_repo路径是否在列表中。
  如果是虚拟环境差异，确保两台机器都激活相同的虚拟环境（若使用了虚拟环境）。

4. 添加__init__.py（可选） #

在my_repo、installations、topology、utils目录下都创建空的__init__.py文件，强制让Python将这些目录识别为包，部分旧环境下能解决识别问题。

内容的提问来源于stack exchange，提问作者Shireto.Dor