Python跨目录导入模块失败求助：无法找到kinematics模块

问题分析 #

你当前代码把kinematics目录添加到了sys.path，但尝试用from kinematics import inverse_kinematics导入时，Python会在sys.path中寻找名为kinematics的模块/包，而此时kinematics目录本身就在sys.path里，里面的inverse_kinematics.py是可直接导入的模块，并非kinematics包的子模块。另外PYTHONPATH添加后未生效，大概率是环境未刷新或路径配置有误。

解决方案 #

方案1：将项目根目录添加到sys.path #

这是最稳妥的方式，让Python能识别project下的所有子包：

import os
import sys
# 从agent_server.py所在目录向上退一级，获取project目录的绝对路径
project_root = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
sys.path.append(project_root)

# 现在可直接从kinematics包导入模块
from kinematics import inverse_kinematics

方案2：直接导入模块（基于现有sys.path设置） #

既然已将kinematics目录加入sys.path，可直接导入模块本身，无需前缀：

import os
import sys
sys.path.append(os.path.join(os.path.abspath(os.path.dirname(__file__)), '..', 'kinematics'))

# 直接导入inverse_kinematics模块
import inverse_kinematics

方案3：使用相对导入（需注意运行方式） #

若项目以包结构组织，可使用相对导入，但不能直接运行agent_server.py，需从project目录执行：

# agent_server.py中的代码
from ..kinematics import inverse_kinematics

运行命令（在project目录下执行）：

python -m distributed_computing.agent_server

验证PYTHONPATH是否生效 #

若添加PYTHONPATH后问题仍存在，在代码开头添加打印语句，确认目标路径是否在sys.path中：

import sys
print(sys.path)

如果未看到你添加的C:\Users\TheCh\.......\project，说明环境变量未生效——重启终端/IDE，或在IDE的运行配置中手动添加该路径。

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