1. 从零到一为什么我决定把“配置功能包”单独写成一篇文章先说个背景。我是在校生专业跟机器人八竿子打不着纯粹因为对智能小车感兴趣才一头扎进ROS这个坑里。断断续续学了快两个月从一个连catkin_make是什么都不知道的小白到现在能跑通一个简单的仿真路径规划中间踩过的坑、绕过的弯比代码行数还多。之所以把“配置功能包”作为系列第一篇很多人会觉得奇怪——功能包不就是catkin_create_pkg一条命令的事吗有什么好讲的但根据我这两个月的真实经历恰恰是这一步没走稳导致后续所有环节都在连环报错。路径规划、动态避障、激光雷达数据处理这些听起来高大上的功能最后都要以“节点”的形式运行在功能包里。功能包结构搭得乱后面写C或Python节点的时候include路径找不到、消息类型依赖缺失、launch文件启动报错这些问题有一半都能追溯到最初功能包配置不规范。这篇文章我会完全按照自己实际操作过的方式从环境准备、工作空间创建、功能包配置写到目录结构设计和常见错误排查所有命令都是我自己在终端里跑过的。适合正在自学ROS、想给自己的智能小车加路径规划功能、但又被各种术语劝退的朋友。哪怕你现在对ROS一无所知只要会开终端、能按回车跟着做也能把基础搭起来。2. 功能包配置前先把ROS环境这层地基打牢2.1 版本选择是第一个坑别装完了才发现不匹配ROS的版本跟Ubuntu版本是严格绑定的。我之前差点在Ubuntu 22.04上装ROS Noetic后来一查资料发现Noetic只支持Ubuntu 20.04真要装也不是不行但依赖关系会乱成一锅粥。这里直接给结论Ubuntu版本ROS版本备注20.04Noetic目前资料最多、教程最全适合新手22.04ROS 2 Humble新型号但很多老教程是基于ROS 1的我自己选的是Ubuntu 20.04 ROS Noetic。原因很简单学路径规划绕不开move_base、gmapping、AMCL这些经典包而这些包的教程和案例几乎都是基于ROS 1写的。ROS 2虽然有新特性但网上能找到的实战案例还不够多自学容易卡住。硬件方面我用的是基于STC单片机的底盘加树莓派4B树莓派上跑Ubuntu 20.04 Server版通过串口跟底盘通信。如果你的方案是STM32 Jetson Nano或者是Arduino加普通笔记本只要能跑Ubuntu和ROS后面的操作流程完全一样。2.2 ROS Noetic安装一条命令和一堆坑官方wiki推荐用apt直接安装步骤如下sudo sh -c echo deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list sudo apt install curl curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add - sudo apt update sudo apt install ros-noetic-desktop-full这个过程比较漫长下载量大概在8GB左右取决于网络状况可能要等半小时。装完之后还有两步初始化sudo rosdep init rosdep updaterosdep init报错的话多半是网络被重置了多试几次。然后是环境变量配置echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc最后验证一下是否安装成功roscore能正常启动看到一堆RosMaster的日志输出就说明ROS本体没问题了。注意如果你之前装过ROS然后系统里面又装了Anaconda大概率会遇到Python路径冲突。报错信息通常是ModuleNotFoundError: No module named rospkg。这个问题我后面在常见问题排查部分会专门讲这里先提个醒。2.3 双系统、虚拟机还是WSL纯自学的真实建议关于环境跑在哪我三种方式都试过说下感受虚拟机最省心VMware或者VirtualBox装Ubuntu跟Windows无缝切换坏了直接快照还原。缺点是GPU性能几乎没有做激光雷达点云可视化的时候有点卡帧率上不去。WSL启动快命令行体验好但GUI支持比较麻烦尤其是Rviz和Gazebo这两个重量级可视化工具在WSL里跑需要额外的显示服务器配置对新手不太友好。双系统性能最好但安装有风险分区不对可能搞坏原来的系统。我最终用的是双系统因为后面做路径规划仿真Rviz和Gazebo要同时开虚拟机确实扛不住。如果你是纯自学、先用仿真验证算法建议从虚拟机开始等确定这条路能走通再换双系统。没必要一上来就给自己上强度。3. 手把手创建智能小车路径规划专用工作空间3.1 工作空间和功能包到底是什么关系用生活化的方式理解工作空间像是一个项目文件夹功能包像是里面的子项目模块。你的智能小车路径规划项目可以拆分成底盘控制、传感器数据采集、路径规划、导航决策几个模块每个模块就是单独的功能包。工作空间的典型结构如下catkin_ws/ ├── src/ # 存放所有功能包的源码 │ ├── car_bringup/ # 启动文件、系统集成 │ ├── car_description/ # 机器人URDF模型 │ ├── car_navigation/ # move_base导航配置 │ └── car_sensor/ # 激光雷达等传感器驱动 ├── build/ # 编译中间文件自动生成 ├── devel/ # 开发环境文件、可执行文件 └── install/ # 安装目录可选的路径规划学习最忌讳的就是所有代码堆在一个包里面。我第一次就是建了一个叫car_code的包把所有节点全塞进去结果后面新增一个话题通信就要重新编译整个包改一处错三处最后实在没法维护只能推倒重来。规范的结构不是装样子是给自己省时间。3.2 创建工作空间这两条命令就够了打开终端执行mkdir -p ~/catkin_ws/src cd ~/catkin_ws/src catkin_init_workspace然后回到工作空间根目录编译一次生成必要的编译环境cd ~/catkin_ws catkin_make第一次catkin_make只会编译空的工作空间生成的devel目录里有setup.bash。然后source一下让系统知道这个工作空间的存在source devel/setup.bash为了以后不用每次手动source建议写进~/.bashrcecho source ~/catkin_ws/devel/setup.bash ~/.bashrc source ~/.bashrc验证工作空间是否生效echo $ROS_PACKAGE_PATH如果输出路径里包含/home/你的用户名/catkin_ws/src说明工作空间已经被ROS正确识别了。3.3 创建第一代智能小车功能包参数逐个讲清楚接下来在src目录下创建功能包。以我的小车项目为例第一个功能包用来存放底盘控制相关代码cd ~/catkin_ws/src catkin_create_pkg car_base roscpp rospy std_msgs geometry_msgs重点说下这几个参数的含义。catkin_create_pkg后面跟的是功能包名和依赖项依赖项不是随便写的它决定了你的代码里能#include哪些头文件、能使用哪些消息类型roscpp使用C写节点时的核心库提供ROS节点初始化、话题发布订阅、服务通信等接口rospyPython版的ROS客户端库用Python写节点时使用std_msgs标准消息定义包括Int32、Float32、String、Bool等基础类型geometry_msgs几何相关消息比如Twist速度控制、PoseStamped带时间戳的位姿、Point坐标点为什么底盘控制包要依赖geometry_msgs因为智能小车的速度控制消息类型是geometry_msgs/Twist通过话题/cmd_vel发布给底盘驱动节点。这个消息包含线速度linear.x和角速度angular.z两部分后续做路径规划时move_base最终输出的就是这种消息。一开始没加这个依赖后面编译包含Twist头文件的代码时直接报找不到文件。如果你要写的节点还会用激光雷达数据那建包的时候就要加上sensor_msgs如果计划用TF坐标变换就要加tf2和tf2_ros。依赖就像电源插座提前预留好后面插电器就不用再接排插。创建好的功能包默认结构car_base/ ├── CMakeLists.txt # 编译配置告诉编译器怎么把源码变成可执行文件 ├── package.xml # 包信息声明包名、版本、依赖项描述 ├── include/car_base/ # C头文件目录 ├── src/ # C源文件目录 ├── scripts/ # Python脚本目录需要手动创建 ├── launch/ # launch启动文件目录需要手动创建 ├── config/ # 参数配置文件目录需要手动创建 └── urdf/ # 机器人模型文件目录需要手动创建3.4 手动补齐目录和初始代码别让空包骗了自己刚刚创建的功能包只有CMakeLists.txt和package.xml后面真正要写的代码还需要几个子目录。手动创建cd ~/car_base mkdir -p launch config scripts然后跑一次完整编译验证功能包配置是否正确在cd ~/catkin_ws目录下执行catkin_make编译成功后功能包就会被ROS系统识别。可以在任意目录下执行rospack find car_base如果输出/home/你的用户名/catkin_ws/src/car_base说明功能包配置成功。这一步很多新手会忽略觉得能编译过就行。但rospack find验证的是功能包能否被ROS的包管理系统正确索引如果这一步失败后面launch文件里引用这个包时会报包不存在的错误。4. 深入拆解功能包的两个核心文件把配置逻辑彻底搞明白4.1 package.xml功能包的“身份证”用catkin_create_pkg创建功能包后会自动生成package.xml打开看一下?xml version1.0? package format2 namecar_base/name version0.0.1/version description智能小车底盘控制功能包/description maintainer email你的邮箱你的用户名/maintainer licenseMIT/license buildtool_dependcatkin/buildtool_depend build_dependroscpp/build_depend build_dependrospy/build_depend build_dependstd_msgs/build_depend build_dependgeometry_msgs/build_depend exec_dependroscpp/exec_depend exec_dependrospy/exec_depend exec_dependstd_msgs/exec_depend exec_dependgeometry_msgs/exec_depend /packagepackage.xml的主要作用是声明功能包的基本信息和依赖关系。其中build_depend是编译时需要的依赖exec_depend是运行时需要的依赖。很多新手都会忘记把新加的依赖写进去结果编译时找不到头文件报错或者运行时找不到消息类型。后续如果添加了新的依赖需要同时更新build_depend和exec_depend。比如你要在底盘控制节点里使用IMU数据就需要加入sensor_msgs依赖build_dependsensor_msgs/build_depend exec_dependsensor_msgs/exec_depend4.2 CMakeLists.txt功能包的“施工图纸”CMakeLists.txt是功能包编译的核心配置文件自动化生成的内容已经包含了基本框架。打开它主要关注下面几个部分。声明Python和C版本。如果是C节点需要确保编译标准设置正确我使用的是C14set(CMAKE_CXX_STANDARD 14) set(CMAKE_CXX_STANDARD_REQUIRED ON)添加依赖包。find_package用于查找依赖的包这一项比较关键功能包有哪些依赖需要在find_package中列出对应的包find_package(catkin REQUIRED COMPONENTS roscpp rospy std_msgs geometry_msgs sensor_msgs )配置头文件搜索路径。如果用了C需要在include_directories中添加对应的依赖路径这样编译器才能找到头文件include_directories( include ${catkin_INCLUDE_DIRS} )设置可执行文件和目标链接库。这一步是让CMake把src目录下的cpp文件编译成可执行文件。例如给底盘控制节点写一个cpp文件可以这样配置add_executable(car_base_node src/car_base_node.cpp) target_link_libraries(car_base_node ${catkin_LIBRARIES})add_executable第一个参数是节点名称第二个参数是源文件路径target_link_libraries把ROS库链接进来。在实际配置中还有一个频率很高的问题是Python文件也需要声明编译安装如果不声明rosrun在运行Python脚本时会提示找不到文件。这个配置如下catkin_install_python(PROGRAMS scripts/your_node.py DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION} )4.3 一个可以直接抄作业的完整CMakeLists配置这是我现在用的底盘控制功能包的CMakeLists配置压缩了无关内容保留了核心部分cmake_minimum_required(VERSION 3.0.2) project(car_base) set(CMAKE_CXX_STANDARD 14) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(catkin REQUIRED COMPONENTS roscpp rospy std_msgs geometry_msgs sensor_msgs ) catkin_package( CATKIN_DEPENDS roscpp rospy std_msgs geometry_msgs sensor_msgs ) include_directories( include ${catkin_INCLUDE_DIRS} ) # Python脚本 catkin_install_python(PROGRAMS scripts/car_teleop.py DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION} ) # C节点 add_executable(car_base_node src/car_base_node.cpp) target_link_libraries(car_base_node ${catkin_LIBRARIES}) add_dependencies(car_base_node ${${PROJECT_NAME}_EXPORTED_TARGETS} ${catkin_EXPORTED_TARGETS})注意最后一行add_dependencies在项目发布了自定义消息之后这个配置能确保编译顺序正确避免消息相关头文件还没生成就去编译节点导致报错。后面学习过程中如果搞了自定义消息对着这行加就行。5. 智能小车路径规划项目代码目录就该这么规划5.1 按照功能拆分每个包各司其职这是我最开始没做到、后面被折磨得够呛才明白的道理。路径规划项目不是一个大包通吃应该按功能拆成多个功能包。以我的智能小车为例项目结构如下catkin_ws/src/ ├── car_base/ # 底盘控制、串口通信、速度转换 ├── car_sensor/ # 激光雷达、摄像头、IMU的驱动和数据采集 ├── car_navigation/ # move_base路径规划配置、全局和局部规划器配置 ├── car_map/ # SLAM建图相关gmapping/Cartographer配置 └── car_bringup/ # 所有launch文件汇总一键启动整个系统每个包负责一个明确的领域互不干扰。后面如果某个包的代码出了问题只需要单独编译那个包不用每次重写整个工作空间。编译命令也可以指定某个功能包比如只编译导航包catkin_make --pkg car_navigation5.2 节点设计先于编码话题通信是ROS的“神经系统”在动手写代码之前先明确每个功能包内部的节点划分以及节点间的通信方式这在ROS里叫话题通信。以路径规划项目为例节点布局如下节点名所属包订阅话题发布话题功能car_base_nodecar_base/cmd_vel/odom接收速度指令控制底盘运动返回里程计数据lidar_nodecar_sensor无/scan激光雷达数据采集和发布cartographer_nodecar_map/scan/odom/mapSLAM建图move_basecar_navigation/map/scan/amcl_pose/cmd_vel/move_base/goal路径规划和导航决策这个表格是在配置功能包阶段就应该画出来的规划图。因为不同功能包之间靠话题通信所有话题消息类型必须在功能包配置阶段就确定下来。比如move_base订阅的/scan是sensor_msgs/LaserScan类型的消息发布给底盘的/cmd_vel是geometry_msgs/Twist类型。我在配置car_sensor功能包时就因为只加了sensor_msgs没加geometry_msgs后面编译激光雷达数据转换节点时又临时补依赖多花了一个晚上。5.3 launch文件设计把复杂的启动流程封装成一句话路径规划项目很麻烦的一点是系统涉及很多节点传感器驱动、底盘控制、定位、建图、路径规划。如果每次都要一个个rosrun启动不仅浪费时间还容易忘掉依赖关系。launch文件就是为了解决这个问题。以car_bringup为例创建一个启动文件launch !-- 启动底盘控制节点串口设备名和波特率作为参数传递 -- node namecar_base_node pkgcar_base typecar_base_node outputscreen param nameserial_port value/dev/ttyUSB0/ param nameserial_baudrate value115200/ /node !-- 启动激光雷达节点 -- node namelidar_node pkgcar_sensor typelidar_node outputscreen/ !-- 启动tf变换连接底盘坐标系和雷达坐标系 -- node namebase_to_laser pkgtf2_ros typestatic_transform_publisher args0.1 0 0 0 0 0 base_link laser/ /launch在实际配置launch文件时比较容易踩的坑有三个第一个是老花眼型失误把pkg和type引用的包名或节点名写错。pkg是包名type是CMakeLists.txt里add_executable定义的可执行文件名以及Python脚本的文件名。刚开始我把Python节点的type写成了scripts/car_teleop.py以为要带路径结果一直报错后来才发现直接用文件名就行。第二个是outputscreen参数。ROS节点的日志信息默认会输出到日志文件而不是终端。调试阶段一定要加上outputscreen才算把日志打在终端上。第三个是多个节点共享参数的问题。param标签是在launch文件里统一配置参数这样节点写代码时可以不用硬编码参数。比如底盘控制节点的串口号和波特率就是通过这个配置删除了重新编译的烦恼。6. 配置过程中容易踩的5个坑全部帮你踩过了6.1catkin_make编译报错找不到包典型报错Could not find a package configuration file provided by xxx原因功能包的package.xml里声明了依赖但系统中没有安装对应的ROS包。比如你在car_sensor里加了sensor_msgs依赖但系统里没装sensor_msgs。解决办法sudo apt install ros-noetic-sensor-msgs对应的依赖名一般是ros-版本名-包名包名中的下划线换成连字符。6.2 Python节点运行时报ModuleNotFoundError: No module named rospkg原因系统中存在多个Python环境ROS的Python库和当前PATH中的Python不一致最常见的是装了Anaconda后默认Python被换成了Anaconda的Python而Anaconda环境里没有安装rospkg。解决办法修改~/.bashrc把Anaconda的Python环境从系统PATH中移除只在ROS工作时不使用。或者直接不用Anaconda用系统自带的Python。如果已经装了就把Anaconda相关行注释掉# export PATH/home/用户名/anaconda3/bin:$PATH命令行执行source ~/.bashrc后重新运行。6.3rosrun找不到功能包报错类型[rospack] Error: package car_base not found原因有多种可能。工作空间的setup.bash没有被source或者当前的ROS_PACKAGE_PATH不包含你的工作空间路径还有可能是刚创建功能包但没有重新catkin_makeROS包管理系统还没索引到。排查步骤echo $ROS_PACKAGE_PATH source ~/catkin_ws/devel/setup.bash rospack find car_base6.4 编译后节点名和文件对不上场景在scripts目录下写了一个Python脚本编译成功但运行时提示找不到。原因Python脚本在ROS的包管理系统中需要单独声明安装只放在scripts目录里不会自动被识别。解决办法在CMakeLists.txt中加入catkin_install_python(PROGRAMS scripts/xxx.py DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION} )6.5sudo权限导致的环境变量丢失场景使用sudo命令执行roslaunch结果报错找不到ROS命令。原因sudo会切换到root用户而source到~/.bashrc的环境变量是在普通用户下配置的root用户环境里没有。ROS的大部分操作不需要sudo权限除非是安装软件包或访问串口设备。解决办法访问串口如果提示权限不足那应该是把你的用户名加入dialout用户组而不是用sudo运行sudo usermod -a -G dialout $USER重新登录后生效。7. 关于工具链再分享一点我个人的配置心得7.1 串口权限和USB设备别名让小车底盘稳定连接智能小车的底盘通常通过USB转串口模块连接到上位机。第一次插上USB线运行底盘控制节点时大概率会报Permission denied这是没有权限访问串口设备的典型表现。除了把用户加入dialout组之外还有一个很实用的小技巧。每次插拔USB线/dev/ttyUSB0的编号可能变化如果系统里同时接了激光雷达和底盘设备编号可能互换导致节点读到错误的设备。解决办法是给设备配置固定的符号链接。先查看设备信息udevadm info --attribute-walk --name/dev/ttyUSB0找到设备的idVendor和idProduct然后创建udev规则echo KERNELttyUSB*, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, MODE:0666, SYMLINKcar_base | sudo tee /etc/udev/rules.d/99-car-base.rules重载规则sudo udevadm control --reload-rules sudo udevadm trigger重新插拔USB线后会多出一个/dev/car_base设备链接固定指向底盘串口。使用这个固定名称之后就算设备编号变化了也不会影响运行。7.2 环境变量配置写进bashrc比每次手动source省心一百倍常规操作是把工作空间的setup.bash和ROS的setup.bash都写进~/.bashrcsource /opt/ros/noetic/setup.bash source ~/catkin_ws/devel/setup.bash但再往后学多了可能有多个工作空间不要在每个工作空间上都做这个操作。比较好的做法是只把主工作空间的源码加进去其他工作空间需要时再手动source。7.3 代码编辑器和调试工具选择我用的是VS Code加ROS插件可以直接在编辑器里运行roscore、rosrun这些命令还带话题监控视图。后面学到可视化调试时Rqt系列工具是非常好用的调试利器一个rqt_graph能直观看到节点和话题的拓扑关系排错效率高很多。前期功能包配置阶段可以不用急着用但知道有这些工具后面调试路径规划时能省不少时间。8. 后面几篇我打算写些什么这一篇的内容到这里功能包配置的基础部分就完整了。按照我自己的学习计划后续还有几块硬骨头要啃。第二篇要写的是让小车底盘真正动起来。串口通信如何跟STM32单片机对接/cmd_vel话题如何转换成左右轮的速度指令里程计数据如何发布。这部分是路径规划的基础因为规划算法输出的最终目的地是速度指令如果底盘控制链路不稳定路径规划再漂亮也落不了地。第三篇打算写SLAM建图和定位。智能小车要路径规划首先得知道自己在哪这就需要建图。我会基于激光雷达用gmapping或者Cartographer构建环境地图再配合AMCL做定位。第四篇就是重头戏了配置move_base导航框架调整全局路径规划器和局部路径规划器的参数让小车能够在已知地图中自主导航避障。动态避障小车路径规划的核心实现也是在这一篇。写这个系列的目的很简单ROS的学习路径很长网上教程虽多但大多是零散的真正从零开始、一步一步走完全流程的案例并不多。我的水平和那些做比赛的大佬比还差得远但至少我走通的每一步都是真实踩过的踩坑的过程记录下来后面的人绕着走就行。最后分享一个我经过多次测试后养成的小习惯每次对功能包做了改动不管是修改package.xml还是添加了新的源文件先跑一遍catkin_make然后立刻rospack find验证包路径再启动节点测试。三个步骤连在一起把问题掐在最早的环节。功能包配置真的是ROS项目的地基这个基础打结实了后面写代码的效率会高很多。
ROS功能包配置实战：从工作空间到智能小车路径规划项目搭建
1. 从零到一为什么我决定把“配置功能包”单独写成一篇文章先说个背景。我是在校生专业跟机器人八竿子打不着纯粹因为对智能小车感兴趣才一头扎进ROS这个坑里。断断续续学了快两个月从一个连catkin_make是什么都不知道的小白到现在能跑通一个简单的仿真路径规划中间踩过的坑、绕过的弯比代码行数还多。之所以把“配置功能包”作为系列第一篇很多人会觉得奇怪——功能包不就是catkin_create_pkg一条命令的事吗有什么好讲的但根据我这两个月的真实经历恰恰是这一步没走稳导致后续所有环节都在连环报错。路径规划、动态避障、激光雷达数据处理这些听起来高大上的功能最后都要以“节点”的形式运行在功能包里。功能包结构搭得乱后面写C或Python节点的时候include路径找不到、消息类型依赖缺失、launch文件启动报错这些问题有一半都能追溯到最初功能包配置不规范。这篇文章我会完全按照自己实际操作过的方式从环境准备、工作空间创建、功能包配置写到目录结构设计和常见错误排查所有命令都是我自己在终端里跑过的。适合正在自学ROS、想给自己的智能小车加路径规划功能、但又被各种术语劝退的朋友。哪怕你现在对ROS一无所知只要会开终端、能按回车跟着做也能把基础搭起来。2. 功能包配置前先把ROS环境这层地基打牢2.1 版本选择是第一个坑别装完了才发现不匹配ROS的版本跟Ubuntu版本是严格绑定的。我之前差点在Ubuntu 22.04上装ROS Noetic后来一查资料发现Noetic只支持Ubuntu 20.04真要装也不是不行但依赖关系会乱成一锅粥。这里直接给结论Ubuntu版本ROS版本备注20.04Noetic目前资料最多、教程最全适合新手22.04ROS 2 Humble新型号但很多老教程是基于ROS 1的我自己选的是Ubuntu 20.04 ROS Noetic。原因很简单学路径规划绕不开move_base、gmapping、AMCL这些经典包而这些包的教程和案例几乎都是基于ROS 1写的。ROS 2虽然有新特性但网上能找到的实战案例还不够多自学容易卡住。硬件方面我用的是基于STC单片机的底盘加树莓派4B树莓派上跑Ubuntu 20.04 Server版通过串口跟底盘通信。如果你的方案是STM32 Jetson Nano或者是Arduino加普通笔记本只要能跑Ubuntu和ROS后面的操作流程完全一样。2.2 ROS Noetic安装一条命令和一堆坑官方wiki推荐用apt直接安装步骤如下sudo sh -c echo deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main /etc/apt/sources.list.d/ros-latest.list sudo apt install curl curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add - sudo apt update sudo apt install ros-noetic-desktop-full这个过程比较漫长下载量大概在8GB左右取决于网络状况可能要等半小时。装完之后还有两步初始化sudo rosdep init rosdep updaterosdep init报错的话多半是网络被重置了多试几次。然后是环境变量配置echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc最后验证一下是否安装成功roscore能正常启动看到一堆RosMaster的日志输出就说明ROS本体没问题了。注意如果你之前装过ROS然后系统里面又装了Anaconda大概率会遇到Python路径冲突。报错信息通常是ModuleNotFoundError: No module named rospkg。这个问题我后面在常见问题排查部分会专门讲这里先提个醒。2.3 双系统、虚拟机还是WSL纯自学的真实建议关于环境跑在哪我三种方式都试过说下感受虚拟机最省心VMware或者VirtualBox装Ubuntu跟Windows无缝切换坏了直接快照还原。缺点是GPU性能几乎没有做激光雷达点云可视化的时候有点卡帧率上不去。WSL启动快命令行体验好但GUI支持比较麻烦尤其是Rviz和Gazebo这两个重量级可视化工具在WSL里跑需要额外的显示服务器配置对新手不太友好。双系统性能最好但安装有风险分区不对可能搞坏原来的系统。我最终用的是双系统因为后面做路径规划仿真Rviz和Gazebo要同时开虚拟机确实扛不住。如果你是纯自学、先用仿真验证算法建议从虚拟机开始等确定这条路能走通再换双系统。没必要一上来就给自己上强度。3. 手把手创建智能小车路径规划专用工作空间3.1 工作空间和功能包到底是什么关系用生活化的方式理解工作空间像是一个项目文件夹功能包像是里面的子项目模块。你的智能小车路径规划项目可以拆分成底盘控制、传感器数据采集、路径规划、导航决策几个模块每个模块就是单独的功能包。工作空间的典型结构如下catkin_ws/ ├── src/ # 存放所有功能包的源码 │ ├── car_bringup/ # 启动文件、系统集成 │ ├── car_description/ # 机器人URDF模型 │ ├── car_navigation/ # move_base导航配置 │ └── car_sensor/ # 激光雷达等传感器驱动 ├── build/ # 编译中间文件自动生成 ├── devel/ # 开发环境文件、可执行文件 └── install/ # 安装目录可选的路径规划学习最忌讳的就是所有代码堆在一个包里面。我第一次就是建了一个叫car_code的包把所有节点全塞进去结果后面新增一个话题通信就要重新编译整个包改一处错三处最后实在没法维护只能推倒重来。规范的结构不是装样子是给自己省时间。3.2 创建工作空间这两条命令就够了打开终端执行mkdir -p ~/catkin_ws/src cd ~/catkin_ws/src catkin_init_workspace然后回到工作空间根目录编译一次生成必要的编译环境cd ~/catkin_ws catkin_make第一次catkin_make只会编译空的工作空间生成的devel目录里有setup.bash。然后source一下让系统知道这个工作空间的存在source devel/setup.bash为了以后不用每次手动source建议写进~/.bashrcecho source ~/catkin_ws/devel/setup.bash ~/.bashrc source ~/.bashrc验证工作空间是否生效echo $ROS_PACKAGE_PATH如果输出路径里包含/home/你的用户名/catkin_ws/src说明工作空间已经被ROS正确识别了。3.3 创建第一代智能小车功能包参数逐个讲清楚接下来在src目录下创建功能包。以我的小车项目为例第一个功能包用来存放底盘控制相关代码cd ~/catkin_ws/src catkin_create_pkg car_base roscpp rospy std_msgs geometry_msgs重点说下这几个参数的含义。catkin_create_pkg后面跟的是功能包名和依赖项依赖项不是随便写的它决定了你的代码里能#include哪些头文件、能使用哪些消息类型roscpp使用C写节点时的核心库提供ROS节点初始化、话题发布订阅、服务通信等接口rospyPython版的ROS客户端库用Python写节点时使用std_msgs标准消息定义包括Int32、Float32、String、Bool等基础类型geometry_msgs几何相关消息比如Twist速度控制、PoseStamped带时间戳的位姿、Point坐标点为什么底盘控制包要依赖geometry_msgs因为智能小车的速度控制消息类型是geometry_msgs/Twist通过话题/cmd_vel发布给底盘驱动节点。这个消息包含线速度linear.x和角速度angular.z两部分后续做路径规划时move_base最终输出的就是这种消息。一开始没加这个依赖后面编译包含Twist头文件的代码时直接报找不到文件。如果你要写的节点还会用激光雷达数据那建包的时候就要加上sensor_msgs如果计划用TF坐标变换就要加tf2和tf2_ros。依赖就像电源插座提前预留好后面插电器就不用再接排插。创建好的功能包默认结构car_base/ ├── CMakeLists.txt # 编译配置告诉编译器怎么把源码变成可执行文件 ├── package.xml # 包信息声明包名、版本、依赖项描述 ├── include/car_base/ # C头文件目录 ├── src/ # C源文件目录 ├── scripts/ # Python脚本目录需要手动创建 ├── launch/ # launch启动文件目录需要手动创建 ├── config/ # 参数配置文件目录需要手动创建 └── urdf/ # 机器人模型文件目录需要手动创建3.4 手动补齐目录和初始代码别让空包骗了自己刚刚创建的功能包只有CMakeLists.txt和package.xml后面真正要写的代码还需要几个子目录。手动创建cd ~/car_base mkdir -p launch config scripts然后跑一次完整编译验证功能包配置是否正确在cd ~/catkin_ws目录下执行catkin_make编译成功后功能包就会被ROS系统识别。可以在任意目录下执行rospack find car_base如果输出/home/你的用户名/catkin_ws/src/car_base说明功能包配置成功。这一步很多新手会忽略觉得能编译过就行。但rospack find验证的是功能包能否被ROS的包管理系统正确索引如果这一步失败后面launch文件里引用这个包时会报包不存在的错误。4. 深入拆解功能包的两个核心文件把配置逻辑彻底搞明白4.1 package.xml功能包的“身份证”用catkin_create_pkg创建功能包后会自动生成package.xml打开看一下?xml version1.0? package format2 namecar_base/name version0.0.1/version description智能小车底盘控制功能包/description maintainer email你的邮箱你的用户名/maintainer licenseMIT/license buildtool_dependcatkin/buildtool_depend build_dependroscpp/build_depend build_dependrospy/build_depend build_dependstd_msgs/build_depend build_dependgeometry_msgs/build_depend exec_dependroscpp/exec_depend exec_dependrospy/exec_depend exec_dependstd_msgs/exec_depend exec_dependgeometry_msgs/exec_depend /packagepackage.xml的主要作用是声明功能包的基本信息和依赖关系。其中build_depend是编译时需要的依赖exec_depend是运行时需要的依赖。很多新手都会忘记把新加的依赖写进去结果编译时找不到头文件报错或者运行时找不到消息类型。后续如果添加了新的依赖需要同时更新build_depend和exec_depend。比如你要在底盘控制节点里使用IMU数据就需要加入sensor_msgs依赖build_dependsensor_msgs/build_depend exec_dependsensor_msgs/exec_depend4.2 CMakeLists.txt功能包的“施工图纸”CMakeLists.txt是功能包编译的核心配置文件自动化生成的内容已经包含了基本框架。打开它主要关注下面几个部分。声明Python和C版本。如果是C节点需要确保编译标准设置正确我使用的是C14set(CMAKE_CXX_STANDARD 14) set(CMAKE_CXX_STANDARD_REQUIRED ON)添加依赖包。find_package用于查找依赖的包这一项比较关键功能包有哪些依赖需要在find_package中列出对应的包find_package(catkin REQUIRED COMPONENTS roscpp rospy std_msgs geometry_msgs sensor_msgs )配置头文件搜索路径。如果用了C需要在include_directories中添加对应的依赖路径这样编译器才能找到头文件include_directories( include ${catkin_INCLUDE_DIRS} )设置可执行文件和目标链接库。这一步是让CMake把src目录下的cpp文件编译成可执行文件。例如给底盘控制节点写一个cpp文件可以这样配置add_executable(car_base_node src/car_base_node.cpp) target_link_libraries(car_base_node ${catkin_LIBRARIES})add_executable第一个参数是节点名称第二个参数是源文件路径target_link_libraries把ROS库链接进来。在实际配置中还有一个频率很高的问题是Python文件也需要声明编译安装如果不声明rosrun在运行Python脚本时会提示找不到文件。这个配置如下catkin_install_python(PROGRAMS scripts/your_node.py DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION} )4.3 一个可以直接抄作业的完整CMakeLists配置这是我现在用的底盘控制功能包的CMakeLists配置压缩了无关内容保留了核心部分cmake_minimum_required(VERSION 3.0.2) project(car_base) set(CMAKE_CXX_STANDARD 14) set(CMAKE_CXX_STANDARD_REQUIRED ON) find_package(catkin REQUIRED COMPONENTS roscpp rospy std_msgs geometry_msgs sensor_msgs ) catkin_package( CATKIN_DEPENDS roscpp rospy std_msgs geometry_msgs sensor_msgs ) include_directories( include ${catkin_INCLUDE_DIRS} ) # Python脚本 catkin_install_python(PROGRAMS scripts/car_teleop.py DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION} ) # C节点 add_executable(car_base_node src/car_base_node.cpp) target_link_libraries(car_base_node ${catkin_LIBRARIES}) add_dependencies(car_base_node ${${PROJECT_NAME}_EXPORTED_TARGETS} ${catkin_EXPORTED_TARGETS})注意最后一行add_dependencies在项目发布了自定义消息之后这个配置能确保编译顺序正确避免消息相关头文件还没生成就去编译节点导致报错。后面学习过程中如果搞了自定义消息对着这行加就行。5. 智能小车路径规划项目代码目录就该这么规划5.1 按照功能拆分每个包各司其职这是我最开始没做到、后面被折磨得够呛才明白的道理。路径规划项目不是一个大包通吃应该按功能拆成多个功能包。以我的智能小车为例项目结构如下catkin_ws/src/ ├── car_base/ # 底盘控制、串口通信、速度转换 ├── car_sensor/ # 激光雷达、摄像头、IMU的驱动和数据采集 ├── car_navigation/ # move_base路径规划配置、全局和局部规划器配置 ├── car_map/ # SLAM建图相关gmapping/Cartographer配置 └── car_bringup/ # 所有launch文件汇总一键启动整个系统每个包负责一个明确的领域互不干扰。后面如果某个包的代码出了问题只需要单独编译那个包不用每次重写整个工作空间。编译命令也可以指定某个功能包比如只编译导航包catkin_make --pkg car_navigation5.2 节点设计先于编码话题通信是ROS的“神经系统”在动手写代码之前先明确每个功能包内部的节点划分以及节点间的通信方式这在ROS里叫话题通信。以路径规划项目为例节点布局如下节点名所属包订阅话题发布话题功能car_base_nodecar_base/cmd_vel/odom接收速度指令控制底盘运动返回里程计数据lidar_nodecar_sensor无/scan激光雷达数据采集和发布cartographer_nodecar_map/scan/odom/mapSLAM建图move_basecar_navigation/map/scan/amcl_pose/cmd_vel/move_base/goal路径规划和导航决策这个表格是在配置功能包阶段就应该画出来的规划图。因为不同功能包之间靠话题通信所有话题消息类型必须在功能包配置阶段就确定下来。比如move_base订阅的/scan是sensor_msgs/LaserScan类型的消息发布给底盘的/cmd_vel是geometry_msgs/Twist类型。我在配置car_sensor功能包时就因为只加了sensor_msgs没加geometry_msgs后面编译激光雷达数据转换节点时又临时补依赖多花了一个晚上。5.3 launch文件设计把复杂的启动流程封装成一句话路径规划项目很麻烦的一点是系统涉及很多节点传感器驱动、底盘控制、定位、建图、路径规划。如果每次都要一个个rosrun启动不仅浪费时间还容易忘掉依赖关系。launch文件就是为了解决这个问题。以car_bringup为例创建一个启动文件launch !-- 启动底盘控制节点串口设备名和波特率作为参数传递 -- node namecar_base_node pkgcar_base typecar_base_node outputscreen param nameserial_port value/dev/ttyUSB0/ param nameserial_baudrate value115200/ /node !-- 启动激光雷达节点 -- node namelidar_node pkgcar_sensor typelidar_node outputscreen/ !-- 启动tf变换连接底盘坐标系和雷达坐标系 -- node namebase_to_laser pkgtf2_ros typestatic_transform_publisher args0.1 0 0 0 0 0 base_link laser/ /launch在实际配置launch文件时比较容易踩的坑有三个第一个是老花眼型失误把pkg和type引用的包名或节点名写错。pkg是包名type是CMakeLists.txt里add_executable定义的可执行文件名以及Python脚本的文件名。刚开始我把Python节点的type写成了scripts/car_teleop.py以为要带路径结果一直报错后来才发现直接用文件名就行。第二个是outputscreen参数。ROS节点的日志信息默认会输出到日志文件而不是终端。调试阶段一定要加上outputscreen才算把日志打在终端上。第三个是多个节点共享参数的问题。param标签是在launch文件里统一配置参数这样节点写代码时可以不用硬编码参数。比如底盘控制节点的串口号和波特率就是通过这个配置删除了重新编译的烦恼。6. 配置过程中容易踩的5个坑全部帮你踩过了6.1catkin_make编译报错找不到包典型报错Could not find a package configuration file provided by xxx原因功能包的package.xml里声明了依赖但系统中没有安装对应的ROS包。比如你在car_sensor里加了sensor_msgs依赖但系统里没装sensor_msgs。解决办法sudo apt install ros-noetic-sensor-msgs对应的依赖名一般是ros-版本名-包名包名中的下划线换成连字符。6.2 Python节点运行时报ModuleNotFoundError: No module named rospkg原因系统中存在多个Python环境ROS的Python库和当前PATH中的Python不一致最常见的是装了Anaconda后默认Python被换成了Anaconda的Python而Anaconda环境里没有安装rospkg。解决办法修改~/.bashrc把Anaconda的Python环境从系统PATH中移除只在ROS工作时不使用。或者直接不用Anaconda用系统自带的Python。如果已经装了就把Anaconda相关行注释掉# export PATH/home/用户名/anaconda3/bin:$PATH命令行执行source ~/.bashrc后重新运行。6.3rosrun找不到功能包报错类型[rospack] Error: package car_base not found原因有多种可能。工作空间的setup.bash没有被source或者当前的ROS_PACKAGE_PATH不包含你的工作空间路径还有可能是刚创建功能包但没有重新catkin_makeROS包管理系统还没索引到。排查步骤echo $ROS_PACKAGE_PATH source ~/catkin_ws/devel/setup.bash rospack find car_base6.4 编译后节点名和文件对不上场景在scripts目录下写了一个Python脚本编译成功但运行时提示找不到。原因Python脚本在ROS的包管理系统中需要单独声明安装只放在scripts目录里不会自动被识别。解决办法在CMakeLists.txt中加入catkin_install_python(PROGRAMS scripts/xxx.py DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION} )6.5sudo权限导致的环境变量丢失场景使用sudo命令执行roslaunch结果报错找不到ROS命令。原因sudo会切换到root用户而source到~/.bashrc的环境变量是在普通用户下配置的root用户环境里没有。ROS的大部分操作不需要sudo权限除非是安装软件包或访问串口设备。解决办法访问串口如果提示权限不足那应该是把你的用户名加入dialout用户组而不是用sudo运行sudo usermod -a -G dialout $USER重新登录后生效。7. 关于工具链再分享一点我个人的配置心得7.1 串口权限和USB设备别名让小车底盘稳定连接智能小车的底盘通常通过USB转串口模块连接到上位机。第一次插上USB线运行底盘控制节点时大概率会报Permission denied这是没有权限访问串口设备的典型表现。除了把用户加入dialout组之外还有一个很实用的小技巧。每次插拔USB线/dev/ttyUSB0的编号可能变化如果系统里同时接了激光雷达和底盘设备编号可能互换导致节点读到错误的设备。解决办法是给设备配置固定的符号链接。先查看设备信息udevadm info --attribute-walk --name/dev/ttyUSB0找到设备的idVendor和idProduct然后创建udev规则echo KERNELttyUSB*, ATTRS{idVendor}1a86, ATTRS{idProduct}7523, MODE:0666, SYMLINKcar_base | sudo tee /etc/udev/rules.d/99-car-base.rules重载规则sudo udevadm control --reload-rules sudo udevadm trigger重新插拔USB线后会多出一个/dev/car_base设备链接固定指向底盘串口。使用这个固定名称之后就算设备编号变化了也不会影响运行。7.2 环境变量配置写进bashrc比每次手动source省心一百倍常规操作是把工作空间的setup.bash和ROS的setup.bash都写进~/.bashrcsource /opt/ros/noetic/setup.bash source ~/catkin_ws/devel/setup.bash但再往后学多了可能有多个工作空间不要在每个工作空间上都做这个操作。比较好的做法是只把主工作空间的源码加进去其他工作空间需要时再手动source。7.3 代码编辑器和调试工具选择我用的是VS Code加ROS插件可以直接在编辑器里运行roscore、rosrun这些命令还带话题监控视图。后面学到可视化调试时Rqt系列工具是非常好用的调试利器一个rqt_graph能直观看到节点和话题的拓扑关系排错效率高很多。前期功能包配置阶段可以不用急着用但知道有这些工具后面调试路径规划时能省不少时间。8. 后面几篇我打算写些什么这一篇的内容到这里功能包配置的基础部分就完整了。按照我自己的学习计划后续还有几块硬骨头要啃。第二篇要写的是让小车底盘真正动起来。串口通信如何跟STM32单片机对接/cmd_vel话题如何转换成左右轮的速度指令里程计数据如何发布。这部分是路径规划的基础因为规划算法输出的最终目的地是速度指令如果底盘控制链路不稳定路径规划再漂亮也落不了地。第三篇打算写SLAM建图和定位。智能小车要路径规划首先得知道自己在哪这就需要建图。我会基于激光雷达用gmapping或者Cartographer构建环境地图再配合AMCL做定位。第四篇就是重头戏了配置move_base导航框架调整全局路径规划器和局部路径规划器的参数让小车能够在已知地图中自主导航避障。动态避障小车路径规划的核心实现也是在这一篇。写这个系列的目的很简单ROS的学习路径很长网上教程虽多但大多是零散的真正从零开始、一步一步走完全流程的案例并不多。我的水平和那些做比赛的大佬比还差得远但至少我走通的每一步都是真实踩过的踩坑的过程记录下来后面的人绕着走就行。最后分享一个我经过多次测试后养成的小习惯每次对功能包做了改动不管是修改package.xml还是添加了新的源文件先跑一遍catkin_make然后立刻rospack find验证包路径再启动节点测试。三个步骤连在一起把问题掐在最早的环节。功能包配置真的是ROS项目的地基这个基础打结实了后面写代码的效率会高很多。
