ROS2HumblePython节点入门教程

本篇文章主要是结合我之前面试的各种经历和实战开发中遇到的问题解决经验整理的，希望这篇《ROS2 Humble Python节点运行教程》对你有很大帮助！欢迎收藏，分享给更多的需要的朋友学习~

本文详解在 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 运行时环境，脱离环境将报 ModuleNotFoundError 或 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 节点，避免因环境配置错误导致的常见故障。

终于介绍完啦！小伙伴们，这篇关于《ROS2HumblePython节点入门教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！