17370845950

本文详解在 ros2 humble 环境下运行 python 自定义节点的标准化流程，重点解决因未正确设置工作空间环境导致的“找不到节点”或“无法执行”问题，并纠正直接调用可执行文件的错误做法。

在 ROS2（尤其是 Humble 版本）中，Python 节点并非以普通脚本形式直接运行（如 python3 py_node.py），也不能通过绝对路径手动执行生成的可执行文件——这是 ROS2 构建系统（基于 colcon）与包管理机制决定的。正确的流程依赖于工作空间环境的正确初始化和ROS2 命令行工具的规范调用。

✅ 正确步骤：源码构建后运行节点

1. 确保已完成构建
   在你的工作空间根目录（例如 ~/ros2_ws）下执行：

   cd ~/ros2_ws
   colcon build --packages-select my_py_pkg

   构建成功后，install/ 目录下会生成 setup.bash 等环境配置脚本。

2. 正确 source 工作空间环境
   ⚠️ 注意：不要 source ~/.bashrc 来替代此步（这通常无效且可能污染环境）。应明确 source 当前工作空间的安装目录：

   source install/setup.bash

   此命令将把 my_py_pkg 的可执行文件路径、Python 模块路径及 ROS2 插件注册信息注入当前 shell 环境。

3. 使用 ros2 run 启动节点
   语法为：ros2 run
   对于典型 Python 节点（如 py_node），执行：

   ros2 run my_py_pkg py_node

   ROS2 会自动定位并启动该节点，同时完成参数解析、日志初始化、节点名注册等标准流程。

? 关键注意事项

• 不要直接执行 install/ 下的二进制文件（如 ./install/my_py_pkg/lib/my_py_pkg/py_node）：它依赖 setup.bash 注入的 Python 路径和 rclpy 运行时环境，脱离环境将报 ModuleNot

  

  FoundError 或 ImportError。
• 检查 setup.py 配置：确保 entry_points 正确声明了可执行入口，例如：

  entry_points={
      'console_scripts': [
          'py_node = my_py_pkg.py_node:main',
      ],
  },

• 验证环境是否生效：运行 echo $AMENT_PREFIX_PATH，输出应包含 ~/ros2_ws/install；运行 ros2 pkg executables my_py_pkg 应列出 py_node。
• 若仍提示“command not found”，请确认：① 包名拼写完全一致（区分大小写）；② setup.bash 已成功 source（可尝试 env | grep AMENT 验证）；③ 终端未切换至新 shell 且未意外重载 .bashrc 覆盖环境。

遵循这一标准流程，即可稳定、可复现地运行 ROS2 Humble 中的 Python 节点，避免因环境配置错误导致的常见故障。