本文详解在 ros2 humble 环境下运行 python 自定义节点的标准化流程，重点解决因未正确设置工作空间环境导致的“找不到节点”或“无法执行”问题，并纠正直接调用可执行文件的错误做法。
在 ROS2（尤其是 Humble 版本）中，Python 节点并非以普通脚本形式直接运行（如 python3 py_node.py），也不能通过绝对路径手动执行生成的可执行文件——这是 ROS2 构建系统（基于 colcon）与包管理机制决定的。正确的流程依赖于工作空间环境的正确初始化和ROS2 命令行工具的规范调用。
✅ 正确步骤：源码构建后运行节点
-
确保已完成构建
在你的工作空间根目录（例如 ~/ros2_ws）下执行：cd ~/ros2_ws colcon build --packages-select my_py_pkg
构建成功后，install/ 目录下会生成 setup.bash 等环境配置脚本。
-
正确 source 工作空间环境
⚠️ 注意：不要 source ~/.bashrc 来替代此步（这通常无效且可能污染环境）。应明确 source 当前工作空间的安装目录：source install/setup.bash
此命令将把 my_py_pkg 的可执行文件路径、Python 模块路径及 ROS2 插件注册信息注入当前 shell 环境。
-
使用 ros2 run 启动节点
语法为：ros2 run
对于典型 Python 节点（如 py_node），执行：ros2 run my_py_pkg py_node
ROS2 会自动定位并启动该节点，同时完成参数解析、日志初始化、节点名注册等标准流程。
立即学习“Python免费学习笔记（深入）”；
? 关键注意事项
- 不要直接执行 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 节点，避免因环境配置错误导致的常见故障。
