### ROS 中编译和运行 Python 节点文件 #### 工作空间设置 为了使 `bin` 目录下的 Python 文件能够顺利导入位于 `src` 下的模块，在创建 ROS 功能包时需指定构建类型为 `ament_python`，这有助于正确配置环境变量以便于后续操作[^2]。 ```bash cd ~/ros2_ws/src ros2 pkg create --build-type ament_python my_package_name ``` #### 修改 setup.py 和 package.xml 对于基于 `ament_python` 的项目来说，确保 `setup.py` 正确指定了要安装的内容以及依赖关系。同时更新 `package.xml` 来声明必要的依赖项[^1]。 - **setup.py**: 添加如下内容来定义哪些目录应该被包含到安装过程中： ```python from setuptools import find_packages, setup setup( name='my_package', version='0.0.0', packages=find_packages(exclude=['test']), install_requires=[ 'setuptools', # Add other dependencies here. ], zip_safe=True, maintainer='yourself', description='Package Description.', license='Apache License 2.0', tests_require=['pytest'], entry_points={ 'console_scripts': [ 'script_name = package.module:function', # 将脚本映射至函数入口 ], }, ) ``` - **package.xml**: 增加对所需库的支持描述: ```xml <depend>rospy</depend> <!-- 或者 --> <depend>rclpy</depend> ... ``` #### 设置 PYTHONPATH 环境变量 (可选) 如果不想修改项目的结构或者遇到复杂的跨包调用情况，则可以通过临时调整 `PYTHONPATH` 让解释器知道去哪里查找额外的模块。不过这种方法通常只用于调试阶段而不是生产部署。 ```bash export PYTHONPATH=$PYTHONPATH:/path/to/your/package/src ``` #### 运行 Python 节点 完成上述准备工作之后，通过命令行启动节点变得简单得多。只需执行以下指令即可加载并激活所需的 Python 脚本[^4]: ```bash source /opt/ros/<distro>/setup.bash # 替换 <distro> 为你使用的版本号比如 foxy galactic humble等 colcon build # 构建整个工作区中的所有软件包 source install/local_setup.bash # 加载本地安装的信息 ros2 run my_package script_name # 启动名为 script_name 的 Python 可执行文件 ```