ROS2 Humble订阅器导入外部Python模块失败的问题求助

问题原因 #

ROS2运行节点时，Python的sys.path默认只包含ROS2包目录和系统Python路径，你要导入的/home/user/Machine_Learning不在其中，切换目录的操作无法修改sys.path，所以会出现模块找不到的错误。

可行解决方案 #

方法1：在节点代码中手动添加路径 #

在pc_subscriber.py的开头加入以下代码，将外部目录添加到Python路径中：

import sys
from pathlib import Path

# 替换为你的Machine_Learning绝对路径
ml_directory = Path("/home/user/Machine_Learning")
sys.path.append(str(ml_directory.resolve()))

# 现在正常导入模块
from utils import common_utils
from pointpillar import build_network

这种方法简单直接，适合临时测试或小型项目。

方法2：通过ROS2包的setup.py配置（规范做法） #

编辑ROS2包的setup.py，在文件开头添加路径配置，确保节点运行时能找到外部模块：

import sys
from pathlib import Path
from setuptools import setup

# 添加外部目录到Python路径
ml_dir = Path("/home/user/Machine_Learning")
sys.path.insert(0, str(ml_dir.resolve()))

# 原setup.py内容继续保留
package_name = 'object_detection'

setup(
    name=package_name,
    version='0.0.0',
    packages=[package_name],
    data_files=[
        ('share/ament_index/resource_index/packages',
            ['resource/' + package_name]),
        ('share/' + package_name, ['package.xml']),
    ],
    install_requires=['setuptools'],
    zip_safe=True,
    maintainer='user',
    maintainer_email='user@todo.todo',
    description='TODO: Package description',
    license='TODO: License declaration',
    tests_require=['pytest'],
    entry_points={
        'console_scripts': [
            'listener = object_detection.pc_subscriber:main',
        ],
    },
)

修改后重新执行colcon build --packages-select object_detection，再运行节点即可。这种方法符合ROS2的包管理规范，适合长期维护的项目。

方法3：创建软链接 #

将外部模块链接到ROS2包的Python目录下，让ROS2将其视为包内模块：

# 进入ROS2包的Python代码目录
cd /home/user/DL_ws/src/object_detection/object_detection

# 创建utils文件夹的软链接
ln -s /home/user/Machine_Learning/utils ./utils

# 创建pointpillar.py的软链接
ln -s /home/user/Machine_Learning/pointpillar.py ./pointpillar.py

执行colcon build后，直接用原导入语句即可，无需修改代码。注意软链接用绝对路径，避免包移动后失效。

方法4：设置全局PYTHONPATH环境变量 #

在运行节点前，将外部目录添加到PYTHONPATH：

export PYTHONPATH="/home/user/Machine_Learning:$PYTHONPATH"
ros2 run object_detection listener

如果想永久生效，将上述export命令添加到~/.bashrc文件末尾，执行source ~/.bashrc后即可永久生效。这种方法会让所有Python程序都能访问该目录，适合需要频繁使用外部模块的场景。

注意事项 #

• 避免使用os.chdir()切换目录的方式导入模块，ROS2运行节点时的工作目录可能不是脚本所在目录，这种方法不可靠。
• 确保Machine_Learning目录下的utils文件夹包含__init__.py文件（即使是空文件），否则Python无法将其识别为可导入的模块。

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