ROS1 Noetic在Ubuntu 20.04上的完整安装指南-平芜编程栈

1. ROS1快速安装指南：从零基础到完整环境搭建

作为一名在机器人操作系统领域工作多年的开发者，我深知ROS1环境配置对于新手的挑战。今天分享的这套安装方案经过数十次实际项目验证，能帮助你在20分钟内完成Ubuntu系统下的完整ROS1环境部署。我们将以最稳定的ROS1 Noetic版本为例，适配Ubuntu 20.04 LTS系统。

注意：ROS1对Ubuntu版本有严格匹配要求，错误搭配会导致依赖冲突。Noetic是ROS1最后一个LTS版本，官方支持到2025年，建议新项目优先选择。

1.1 基础环境准备

首先确认你的系统环境满足以下条件：

已安装纯净的Ubuntu 20.04.6 LTS（建议使用官方镜像）
拥有至少15GB的可用磁盘空间
能正常访问网络（建议使用国内镜像源加速）

打开终端(Ctrl+Alt+T)执行环境检测命令：

lsb_release -a # 查看系统版本 df -h / # 检查磁盘空间 ping www.baidu.com -c 4 # 测试网络连通性

1.2 配置软件源镜像

为加速下载过程，我们先替换为国内镜像源。这里以清华源为例：

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

更新软件包索引并升级现有组件：

sudo apt update && sudo apt upgrade -y

2. ROS1核心安装流程

2.1 添加ROS官方仓库

设置计算机以接受ROS仓库的软件：

sudo sh -c 'echo "deb http://packages.ros.org/ros/ubuntu $(lsb_release -sc) main" > /etc/apt/sources.list.d/ros-latest.list'

添加官方GPG密钥：

sudo apt install curl curl -s https://raw.githubusercontent.com/ros/rosdistro/master/ros.asc | sudo apt-key add -

2.2 安装完整桌面版ROS

建议安装桌面完整版(Desktop-Full)，包含ROS、rqt、rviz等核心工具：

sudo apt update sudo apt install ros-noetic-desktop-full -y

实测数据：在100M带宽环境下，完整安装包约1.2GB，安装后占用空间约4.3GB。如果网络不稳定，可以使用apt-get download先下载再离线安装。

2.3 环境变量配置

每次启动终端时自动source ROS环境：

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

验证安装是否成功：

roscore & # 后台启动ROS核心 rosnode list # 应显示/rosout节点 killall roscore # 测试完成后关闭

3. 必备工具与依赖安装

3.1 构建工具配置

安装ROS构建系统依赖：

sudo apt install python3-rosdep python3-rosinstall python3-rosinstall-generator python3-wstool build-essential -y

初始化rosdep：

sudo rosdep init rosdep update

3.2 常用功能包补充

安装常用传感器驱动和工具包：

sudo apt install ros-noetic-rqt* ros-noetic-turtlebot3* ros-noetic-slam-gmapping ros-noetic-navigation -y

安装Gazebo仿真环境：

sudo apt install gazebo11 libgazebo11-dev -y sudo apt install ros-noetic-gazebo-ros-pkgs ros-noetic-gazebo-ros-control -y

4. 安装后验证与问题排查

4.1 基础功能测试

启动小海龟仿真测试：

roscore & rosrun turtlesim turtlesim_node rosrun turtlesim turtle_teleop_key

正常情况应出现GUI窗口，通过方向键可控制乌龟移动。

4.2 常见问题解决方案

问题1：rosdep初始化失败

ERROR: cannot download default sources list from...

解决方案：

sudo mkdir -p /etc/ros/rosdep/sources.list.d/ sudo curl -o /etc/ros/rosdep/sources.list.d/20-default.list https://mirrors.tuna.tsinghua.edu.cn/git/rosdistro/raw/master/rosdep/sources.list.d/20-default.list

问题2：Gazebo启动黑屏修改显卡驱动设置：

echo "export SVGA_VGPU10=0" >> ~/.bashrc source ~/.bashrc

问题3：Python版本冲突检查默认Python版本：

python --version # 必须为Python3 sudo update-alternatives --config python # 选择Python3

5. 开发环境配置建议

5.1 IDE集成配置

推荐使用VSCode进行ROS开发：

sudo apt install code code --install-extension ms-iot.vscode-ros code --install-extension twxs.cmake

配置编译快捷键(Ctrl+Shift+B)：

{ "version": "2.0.0", "tasks": [ { "label": "catkin_make", "type": "shell", "command": "catkin_make", "args": [], "group": { "kind": "build", "isDefault": true } } ] }

5.2 工作空间创建标准

建议采用以下目录结构：

mkdir -p ~/catkin_ws/src cd ~/catkin_ws/ catkin_make echo "source ~/catkin_ws/devel/setup.bash" >> ~/.bashrc

在项目开发过程中，我强烈建议使用rosdep install自动解决依赖：

cd ~/catkin_ws rosdep install --from-paths src --ignore-src -y

最后分享一个实用技巧：使用roslaunch --screen可以保留终端输出，调试时非常有用。对于长期运行的节点，建议配合tmux或screen使用，防止SSH断开导致进程终止。

ROS1 Noetic在Ubuntu 20.04上的完整安装指南