跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI 生图工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
C++AI算法

Ubuntu 22.04 安装 ROS2 Humble 环境配置指南

Ubuntu 22.04 环境下安装 ROS2 Humble 版本需完成环境准备、仓库添加、组件安装及变量配置。关键步骤包括使用清华源加速下载、执行 sudo apt 安装 ros-humble-desktop、将 setup.bash 写入 .bashrc。验证方法包含运行 turtlesim 节点及查看 pkg 列表。常见问题如 apt 更新失败可通过清理缓存解决,命令不可用则需检查路径配置。此外建议配置自动补全及 Colcon 编译工具以提升开发效率。

RedisGeek发布于 2025/10/25更新于 2026/9/1064 浏览
Ubuntu 22.04 安装 ROS2 Humble 环境配置指南

概述

本文介绍在 Ubuntu 22.04 系统上安装 ROS2 Humble 版本的完整流程,涵盖环境准备、仓库配置、组件安装及验证步骤。

环境准备

1. 系统版本确认

打开终端输入以下命令确认系统版本:

lsb_release -a

需显示 Ubuntu 22.04.x LTS。

2. 更换软件源

国内用户建议更换为清华源以提升下载速度:

sudo sed -i 's@http://.*archive.ubuntu.com@https://mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list
sudo sed -i 's@http://.*security.ubuntu.com@https://mirrors.tuna.tsinghua.edu.cn@g' /etc/apt/sources.list

安装步骤

1. 添加 ROS2 仓库

sudo apt update && sudo apt install curl gnupg lsb-release
sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(source /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

2. 安装核心组件

推荐安装桌面版(包含 GUI 工具):

sudo apt update
sudo apt install ros-humble-desktop

若仅需开发基础包,可选择 ros-humble-ros-base。

3. 环境变量配置

将 ROS2 环境变量写入 .bashrc 文件:

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

验证安装

方法 1:小海龟测试

在三个终端分别运行以下命令:

# 终端 1
ros2 run turtlesim turtlesim_node
# 终端 2
ros2 run turtlesim turtle_teleop_key
# 终端 3
rqt_graph

观察节点连线图及乌龟移动控制情况。

方法 2:查看软件包列表

ros2 pkg list | grep turtlesim

若输出包含 turtlesim,说明组件安装完整。

常见问题

1. apt update 报错

症状:Failed to download repository information 解法:清理缓存后重试

sudo rm -rf /var/lib/apt/lists/*
sudo apt update

2. ROS 命令找不到

症状:ros2: command not found 解法:检查 .bashrc 路径配置是否正确。

进阶配置

1. 自动补全

sudo apt install python3-argcomplete ros2-complete

2. Colcon 编译工具

sudo apt install python3-colcon-common-extensions
mkdir -p ~/ros2_ws/src
cd ~/ros2_ws
colcon build

目录

  1. 概述
  2. 环境准备
  3. 1. 系统版本确认
  4. 2. 更换软件源
  5. 安装步骤
  6. 1. 添加 ROS2 仓库
  7. 2. 安装核心组件
  8. 3. 环境变量配置
  9. 验证安装
  10. 方法 1:小海龟测试
  11. 终端 1
  12. 终端 2
  13. 终端 3
  14. 方法 2:查看软件包列表
  15. 常见问题
  16. 1. apt update 报错
  17. 2. ROS 命令找不到
  18. 进阶配置
  19. 1. 自动补全
  20. 2. Colcon 编译工具

更多推荐文章

查看全部
  • LLaMA-Factory 全流程模型训练指南
  • Windows 11 使用 llama.cpp 运行 Qwen3.5 量化模型测试
  • Web3 社区运营指南:构建、激励与增长策略
  • 大模型上下文窗口 200k 到底是什么
  • 算法实战:课程表环检测与 Trie 前缀树实现
  • 30 岁转行网络安全:可行性与职业发展深度解析
  • 大型语言模型用于疾病诊断的范围综述
  • JavaScript Generator 函数详解:异步控制流与状态机应用
  • 本地部署 GLM-4.7-Flash 打造私有编程 Copilot
  • Android WebRTC 远程控制实战:从协议解析到低延迟优化
  • GitHub Copilot 配置最佳实践
  • AC-MPC:微分 MPC 赋能强化学习,实现超人级无人机竞速
  • Stable Diffusion XL 1.0 镜像免配置方案:灵感画廊部署指南
  • Flask 工厂模式与蓝图设计:构建可扩展大型应用架构
  • Stable Diffusion 3.5 本地部署与使用指南
  • Llama-Factory 启用 Flash Attention 的配置与训练加速
  • 【每天一个知识点】Midjourney
  • 递归搜索与回溯算法综合练习:暴搜决策树详解
  • 昇腾 NPU 部署 Llama 2 模型:性能测试与优化实战
  • 专利 CN118134841A:光伏产品缺陷检测 AI 深度学习算法解析

相关免费在线工具

  • 加密/解密文本

    使用加密算法(如AES、TripleDES、Rabbit或RC4)加密和解密文本明文。 在线工具,加密/解密文本在线工具,online

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Gemini 图片去水印

    基于开源反向 Alpha 混合算法去除 Gemini/Nano Banana 图片水印,支持批量处理与下载。 在线工具,Gemini 图片去水印在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online