第1章:ROS2开发环境搭建

大家好,我是你们的老朋友。今天咱们来聊聊ROS2开发环境搭建这件事。

说实话,我见过太多初学者卡在这一步。明明代码写得挺好,结果环境没配好,一编译就报错。嗯,我自己也踩过不少坑。所以这一章,我会把经验都掏出来。

1.1 Ubuntu系统安装与配置

ROS2 Humble官方推荐的是Ubuntu 22.04 LTS。我个人习惯用LTS版本,稳定,省心。你想想看,做嵌入式开发,系统三天两头崩,谁受得了?

安装方式有两种:

  • 双系统安装:性能最好,适合长期开发
  • 虚拟机安装:方便切换,适合尝鲜或学习

我建议初学者先用虚拟机。为什么?因为我在项目中遇到过,双系统装完发现磁盘分区不够,重装又得折腾半天。虚拟机随时可以快照,玩坏了恢复就行。

小提示:虚拟机推荐分配至少4GB内存、40GB磁盘。别抠门,否则编译到一半卡死,你会想砸电脑的。

安装后的基本配置:

  1. 更换软件源为国内镜像(阿里云、清华、中科大都可以)
  2. 执行 sudo apt update && sudo apt upgrade -y
  3. 安装基础工具:sudo apt install vim curl wget git -y
注意:千万别跳过换源这一步。我曾经用默认源下载ROS2,等了两个小时还没下完。换了镜像源,十分钟搞定。

1.2 ROS2 Humble的安装与验证

ROS2 Humble是2022年发布的版本,支持到2027年。说白了,现在学它,未来三五年都不过时。

安装步骤:

  1. 设置编码:sudo apt install locales && sudo locale-gen en_US en_US.UTF-8
  2. 添加ROS2源:sudo apt install software-properties-common && sudo add-apt-repository universe
  3. 安装ROS2 Humble桌面版:sudo apt install ros-humble-desktop -y
  4. 安装开发工具:sudo apt install ros-dev-tools -y

安装完成后,记得配置环境变量。我个人习惯把它写到 ~/.bashrc 里:

echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
source ~/.bashrc

验证安装:

打开两个终端。第一个运行:

ros2 run demo_nodes_cpp talker

第二个运行:

ros2 run demo_nodes_py listener

如果看到双方在互相发送和接收消息,恭喜你,安装成功了!

重要:如果遇到 command not found,八成是环境变量没配好。检查一下 ~/.bashrc 里有没有source那一行。

1.3 开发工具链安装

工欲善其事,必先利其器。下面这几样,是我做ROS2开发必装的。

VS Code

我个人觉得VS Code是ROS2开发的最佳编辑器。插件生态好,调试方便。

安装方式:

sudo snap install code --classic

或者去官网下载deb包安装。装完后推荐安装这几个插件:

  • ROS(微软官方出品)
  • Python
  • C/C++
  • CMake Tools
  • GitLens

Git

版本控制是基本功。Ubuntu自带Git,但版本可能比较老。我建议更新到最新版:

sudo add-apt-repository ppa:git-core/ppa
sudo apt update
sudo apt install git -y

配置一下你的信息:

git config --global user.name "你的名字"
git config --global user.email "你的邮箱"

Colcon

Colcon是ROS2的编译工具。说白了,它就是用来编译你的ROS2工作空间的。

安装:

sudo apt install python3-colcon-common-extensions -y
经验之谈:我刚开始用Colcon时,经常忘记 --symlink-install 参数。加上这个参数后,修改Python文件就不用重新编译了,开发效率翻倍。

1.4 工作空间创建与编译测试

好了,环境都配好了,咱们来创建第一个ROS2工作空间。

创建步骤:

  1. 创建工作空间目录:mkdir -p ~/ros2_ws/src
  2. 进入src目录:cd ~/ros2_ws/src
  3. 创建一个测试包:ros2 pkg create test_pkg --build-type ament_cmake
  4. 返回工作空间根目录:cd ~/ros2_ws
  5. 编译:colcon build --symlink-install

编译成功后,你会看到 buildinstalllog 三个目录。记得source一下:

source install/setup.bash

验证一下:

ros2 pkg list | grep test_pkg

如果能看到 test_pkg,说明工作空间配置成功了。

避坑指南:我曾经犯过一个低级错误——每次打开新终端都忘了source工作空间。后来我直接把 source ~/ros2_ws/install/setup.bash 写进了 ~/.bashrc,再也没忘过。

编译常见问题:

问题 原因 解决方法
找不到ros2命令 环境变量未配置 检查 ~/.bashrc 中的source语句
编译报错:找不到依赖 缺少ROS2包 rosdep install 安装依赖
编译速度慢 单线程编译 colcon build --parallel-workers 4

嗯,到这里,ROS2开发环境就搭建好了。你可能会觉得步骤有点多,但相信我,一次配好,后面就顺了。下一章咱们开始写第一个ROS2节点,到时候你就知道今天这些功夫没白费。

有什么问题,欢迎随时交流。咱们下章见!


公众号:蓝海资料掘金营,微信deep3321