Python 'No module named'报错：SSH环境poseConv模块导入失败

可能的原因 #

• 远程运行脚本时，Python模块搜索路径（sys.path）未包含项目根目录：本地运行时，IDE通常会自动将项目根目录加入搜索路径，或你从根目录启动脚本；但远程如果直接在tools目录下运行test.py，此时工作目录为tools，poseConv所在的根目录不在sys.path中，导致无法找到模块。
• 远程未激活项目对应的虚拟环境：本地使用venv隔离环境，远程若未激活，可能出现依赖缺失或环境路径冲突。
• 远程项目文件不完整或权限不足：poseConv目录下的子模块文件（如dataset/builder.py）、__init__.py缺失，或当前用户无文件读取权限。

解决办法 #

1. 在脚本中手动添加项目根目录到搜索路径 #

在test.py最顶部添加以下代码，强制将项目根目录加入Python模块搜索路径：

import sys
import os
# 获取当前脚本的上级目录（即项目根目录）
root_dir = os.path.dirname(os.path.dirname(os.path.abspath(__file__)))
sys.path.append(root_dir)

2. 从项目根目录启动脚本 #

不要进入tools目录运行，切换到项目根目录后执行：

python tools/test.py

这种方式下，Python会自动将当前工作目录（项目根）加入sys.path，无需额外配置。

3. 激活远程的虚拟环境 #

登录远程服务器后，先激活项目的虚拟环境，再运行脚本：

source venv/bin/activate
# 之后运行脚本，比如从根目录执行
python tools/test.py

4. 检查文件完整性与权限 #

• 确认远程服务器上poseConv目录下的所有必要文件（包括子目录中的.py文件、__init__.py）完整，若缺失则重新同步项目文件。
• 若存在权限问题，调整文件权限：

chmod -R 644 poseConv/

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