如何在Docker容器中运行ROS2包的单个Python节点？

核心前提：先加载工作空间环境 #

在容器内的~/ros2/foxy路径下，必须先执行环境变量配置命令，这是ROS2识别本地包的关键：

source install/setup.bash

如果容器默认shell是zsh，替换为source install/setup.zsh。

验证环境配置有效性 #

执行以下命令确认你的包已被ROS2识别：

ros2 pkg list | grep package_name

如果能输出目标包名，说明环境配置成功；若没有输出，排查以下几点：

• 检查colcon build过程是否有报错，确保编译完全成功
• 确认目标包的文件结构符合ROS2规范：必须包含package.xml、setup.py（Python包），且放在~/ros2/foxy/src目录下
• 确认之前的--packages-up-to system_integration参数是否包含了你要运行的package_name，如果没包含，重新编译时指定目标包：

  colcon build --symlink-install --event-handlers console_cohesion+ --cmake-args -DCMAKE_BUILD_TYPE=Release --packages-select package_name
  

运行Python节点 #

环境配置正确后，直接执行节点启动命令：

ros2 run package_name node_name

注意：这里的node_name是你在setup.py的entry_points中定义的可执行名称，不是Python脚本的文件名。

额外排查点 #

• 若以root用户运行容器，部分ROS2版本需先设置域ID：export ROS_DOMAIN_ID=0
• 确保容器基础镜像已安装ROS2 Foxy的Python依赖（比如python3-colcon-common-extensions），若缺失可通过apt install补充安装

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