夜雨聆风适用系统：Ubuntu 26.04 Resolute（最新正式版）
适配ROS版本：ROS2 Lyrical（2026 全新 LTS 长期支持版，5年官方维护）
教程特点：全程国内清华镜像、无翻墙、一键脚本安装、零冗余步骤、附带安装验证+常见报错解决，新手零基础可直接上手。
ROS2 Lyrical 是目前 ROS2 最新的长期支持版本，完美适配 Ubuntu26.04 系统，相较于旧版本 Humble、Iron，在编译速度、兼容性、系统适配性上全面升级，是2026年机器人开发、自动驾驶、移动机器人项目的首选版本。
本篇教程放弃繁琐的分步手动配置，提供全自动一键安装脚本，同时保留完整手动原理，兼顾新手快速部署和老手学习需求。
一、环境前置说明
1. 系统必须为 Ubuntu 26.04，其他版本（22.04/24.04）不适配 Lyrical 版本；
2. 全程使用清华国内镜像，彻底解决官方源下载慢、超时、连接失败问题；
3. 脚本默认安装桌面完整版，包含 RViz2、rqt、Gazebo 仿真、导航全套工具，满足绝大多数开发场景。
二、全自动一键安装（推荐新手）
无需逐行敲命令，复制全套脚本，一键完成环境配置、源添加、安装、环境变量、rosdep 初始化。
步骤1：新建安装脚本文件
打开终端，输入命令创建脚本文件：
touch install_ros2.sh
步骤2：写入完整安装脚本
编辑脚本文件：
gedit install_ros2.sh
将以下全部代码复制粘贴到文件中，保存退出：
#!/bin/bash# 脚本中任意命令返回非 0 退出码（失败）时，立即终止脚本执行set -eecho "============================================="echo " Ubuntu 26.04 一键安装 ROS 2 Lyrical 最新版 "echo " 已适配官方架构 · 无废弃依赖 · 纯净版 "echo "============================================="# 1. 配置 UTF-8 编码sudo apt update && sudo apt install -y localessudo locale-gen en_US en_US.UTF-8sudo update-locale LC_ALL=en_US.UTF-8 LANG=en_US.UTF-8export LANG=en_US.UTF-8# 2. 启用系统仓库sudo apt install -y software-properties-common curlsudo add-apt-repository universe -y# 3. 添加 ROS 2 密钥 + 清华镜像源sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpgecho "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] https://mirrors.tuna.tsinghua.edu.cn/ros2/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null# 4. 安装 ROS 2 桌面完整版 + 开发工具sudo apt updatesudo apt upgrade -ysudo apt install -y ros-lyrical-desktop ros-dev-tools# 5. 配置环境变量（永久生效）echo "source /opt/ros/lyrical/setup.bash" >> ~/.bashrcsource ~/.bashrc# 6. 安装完成验证echo -e "\n✅ 安装成功！ROS 2 信息如下："echo "ROS 版本：$ROS_DISTRO"echo "测试命令请开两个终端分别执行："echo "终端1：ros2 run demo_nodes_cpp talker"echo "终端2：ros2 run demo_nodes_py listener"
步骤3：赋予权限并执行安装
终端依次输入以下两条命令，等待自动安装完成（全程无需手动操作）：
chmod +x install_ros2.sh./install_ros2.sh
安装过程约3-10分钟，取决于网络速度，全程自动处理依赖、配置环境。
三、安装结果验证（必做）
安装完成后，新开终端，执行版本查询命令，输出版本号即代表安装成功：
echo $ROS_DISTRO #显示 lyrical 表示版本正确经典通讯测试（验证功能完整性）
这是 ROS2 官方标准测试，验证节点通讯功能是否正常。
终端1：启动发布节点
ros2 run demo_nodes_cpp talker
正常输出：持续打印 Publishing: Hello World
终端2：启动订阅节点
ros2 run demo_nodes_py listener
正常输出：持续接收并打印发布的消息，代表 ROS2 通讯环境完全正常。
四、三种安装版本区别（按需选择）
脚本默认安装桌面完整版，适合绝大多数开发者，如需轻量化版本，可替换安装命令：
1. 完整版（默认）：ros-lyrical-desktop 含仿真、可视化、全套工具，推荐新手/开发使用
2. 基础版：ros-lyrical-ros-base 仅核心功能，无可视化，适合工控机、嵌入式设备
3. 开发工具包：ros-dev-tools 编译、构建、调试必备工具
五、常见问题与解决方案
1. rosdep update 超时/失败
原因：默认源国外网络不稳定，解决方案：替换清华 rosdep 国内源，秒更新成功。
2. 终端提示命令不存在
解决：关闭当前终端，重新打开新终端，环境变量自动生效即可。
3. Ubuntu26.04 Wayland 界面兼容问题
Ubuntu26.04 默认 Wayland 桌面，部分 RViz 可视化工具可能卡顿，建议登录界面切换为 X11 模式。
4. 软件源下载速度慢
本脚本已内置清华镜像，若依旧缓慢，可切换中科大 ROS2 镜像源。
六、写在最后
ROS2 Lyrical 作为 2026 年最新 LTS 版本，未来5年无需升级迭代，适配最新的机器人算法、仿真平台、自动驾驶框架。
本教程全程无坑、无翻墙、全自动部署，零基础也能快速搭建好 ROS2 开发环境，适合课程学习、项目开发、科研实验使用。
后续会持续更新 ROS2 Lyrical 入门教程、功能实操、仿真开发、机器人实战案例，欢迎关注收藏！
