从零开始Ubuntu 20.04安装ROS Noetic全流程避坑指南刚接触机器人开发的朋友们安装ROS往往是你们遇到的第一个挑战。作为机器人领域的操作系统ROS的安装过程却常常让新手们头疼不已——特别是国内网络环境下各种报错、依赖问题层出不穷。本文将用最详细的方式带你一步步完成ROS Noetic在Ubuntu 20.04上的安装特别针对国内用户优化了镜像源配置并整理了20个常见错误的解决方案。1. 准备工作与环境检查在开始安装ROS之前我们需要确保系统环境已经准备就绪。很多安装失败的问题其实源于前期准备不足。1.1 系统版本确认首先确认你的Ubuntu版本是否为20.04Focal Fossa这是ROS Noetic官方支持的版本。在终端执行lsb_release -a预期输出应包含Distributor ID: Ubuntu Description: Ubuntu 20.04.x LTS Release: 20.04 Codename: focal注意虽然其他Ubuntu版本也可能安装成功但官方仅对20.04提供完整支持使用其他版本可能导致依赖问题。1.2 基础软件包更新在安装ROS前建议先更新系统已有软件包sudo apt update sudo apt upgrade -y这个步骤经常被忽略但能解决很多后续的依赖冲突问题。更新完成后建议重启系统sudo reboot1.3 必备工具安装ROS安装过程中需要用到一些工具建议提前安装sudo apt install -y curl git python3-pip这些工具将用于密钥管理、源码克隆和Python包管理。特别是curl在后续设置密钥时会用到。2. 软件源配置与镜像优化国内用户安装ROS最大的障碍就是网络连接问题。本节将详细介绍如何配置国内镜像源大幅提升安装速度和成功率。2.1 Ubuntu主源配置首先确保系统已启用所有必要的软件仓库sudo add-apt-repository deb http://archive.ubuntu.com/ubuntu $(lsb_release -sc) main restricted universe multiverse也可以通过图形界面配置打开软件和更新应用在Ubuntu软件选项卡下勾选所有四个仓库选项点击关闭并重新加载软件包信息2.2 ROS镜像源设置官方ROS源在国内访问较慢建议使用清华镜像源sudo sh -c . /etc/lsb-release echo deb http://mirrors.tuna.tsinghua.edu.cn/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list其他可选镜像源如中科大源# 中科大ROS源 sudo sh -c . /etc/lsb-release echo deb http://mirrors.ustc.edu.cn/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list2.3 密钥配置与验证ROS软件包需要验证密钥国内用户常在此步骤失败。以下是优化后的密钥设置方法sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654验证密钥是否添加成功apt-key list | grep ROS Builder预期应看到类似输出pub rsa2048 2020-05-23 [SC] [有效至2025-05-21] C1CF 6E31 E6BA DE88 68B1 72B4 F42E D6FB AB17 C654 uid [ 未知 ] ROS Builder rosbuildros.org常见问题如果密钥服务器无法连接可以尝试更换为hkp://pgp.mit.edu:80或hkp://keyserver.ubuntu.com:113713. ROS Noetic完整安装3.1 桌面完整版安装推荐安装桌面完整版(Desktop-Full)包含ROS、rqt、rviz等常用工具sudo apt update sudo apt install -y ros-noetic-desktop-full安装过程可能需要15-30分钟取决于网络速度。如果中途失败可以尝试sudo apt --fix-broken install然后重新运行安装命令。3.2 基础依赖安装安装构建ROS包所需的工具和依赖sudo apt install -y python3-rosdep python3-rosinstall python3-rosinstall-generator python3-wstool build-essential3.3 rosdep初始化rosdep是管理ROS依赖的重要工具初始化过程常因网络问题失败sudo rosdep init rosdep update国内用户如果遇到rosdep update失败可以尝试以下方法修改hosts文件echo 151.101.84.133 raw.githubusercontent.com | sudo tee -a /etc/hosts使用国内镜像源rosdep update --include-eol-distros --rosdistro noetic提示如果仍然失败可以尝试多次执行rosdep update网络状况不好时可能需要重复5-10次。4. 环境配置与验证4.1 环境变量设置将ROS环境变量添加到bashrc中echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc对于zsh用户echo source /opt/ros/noetic/setup.zsh ~/.zshrc source ~/.zshrc4.2 安装验证验证ROS版本rosversion -d预期输出noetic4.3 基础功能测试启动ROS核心服务roscore在新终端中运行小乌龟模拟器rosrun turtlesim turtlesim_node再开一个终端控制乌龟移动rosrun turtlesim turtle_teleop_key操作提示确保焦点在控制终端使用方向键移动乌龟。5. 常见问题解决方案5.1 安装过程中的典型错误错误现象可能原因解决方案E: Unable to locate package ros-noetic-desktop-full软件源未正确配置检查/etc/apt/sources.list.d/ros-latest.list内容确保格式正确GPG error: NO_PUBKEY F42ED6FBAB17C654密钥未正确添加重新执行密钥添加命令或尝试不同的密钥服务器rosdep update超时网络连接问题修改hosts或使用代理工具ImportError: No module named rospkgPython环境问题执行pip install -U rospkg5.2 ROS环境变量问题如果遇到ROS_DISTRO未设置等环境问题可以手动设置export ROS_DISTROnoetic export ROS_PACKAGE_PATH/opt/ros/noetic/share export PATH$PATH:/opt/ros/noetic/bin5.3 图形界面相关问题如果rviz或gazebo无法启动可能需要安装OpenGL相关驱动sudo apt install -y libgl1-mesa-dev libglu1-mesa-dev对于虚拟机用户可能需要启用3D加速或使用软件渲染export LIBGL_ALWAYS_SOFTWARE16. 进阶配置与优化6.1 创建工作空间建议为开发项目创建独立的工作空间mkdir -p ~/catkin_ws/src cd ~/catkin_ws/ catkin_make source devel/setup.bash将此命令添加到bashrc中echo source ~/catkin_ws/devel/setup.bash ~/.bashrc6.2 多版本ROS共存如果需要同时使用多个ROS版本可以通过以下方式切换# 切换到Noetic source /opt/ros/noetic/setup.bash # 切换到其他版本 source /opt/ros/melodic/setup.bash6.3 性能优化建议对于资源有限的开发板可以安装精简版sudo apt install ros-noetic-ros-base关闭不必要的可视化工具可以节省资源export ROS_NOETIC_IGNORE_GUI17. 后续学习建议成功安装ROS只是第一步建议从以下资源开始学习官方教程roscd turtlesim查看示例代码交互式学习安装ros-noetic-ros-tutorials包社区资源ROS Wiki和Stack Overflow上的中文讨论遇到问题时记住三个调试命令rostopic list # 查看当前话题 rosnode list # 查看运行中的节点 rqt_graph # 可视化节点关系
保姆级教程：在Ubuntu 20.04上从零安装ROS Noetic（含国内镜像源配置）
从零开始Ubuntu 20.04安装ROS Noetic全流程避坑指南刚接触机器人开发的朋友们安装ROS往往是你们遇到的第一个挑战。作为机器人领域的操作系统ROS的安装过程却常常让新手们头疼不已——特别是国内网络环境下各种报错、依赖问题层出不穷。本文将用最详细的方式带你一步步完成ROS Noetic在Ubuntu 20.04上的安装特别针对国内用户优化了镜像源配置并整理了20个常见错误的解决方案。1. 准备工作与环境检查在开始安装ROS之前我们需要确保系统环境已经准备就绪。很多安装失败的问题其实源于前期准备不足。1.1 系统版本确认首先确认你的Ubuntu版本是否为20.04Focal Fossa这是ROS Noetic官方支持的版本。在终端执行lsb_release -a预期输出应包含Distributor ID: Ubuntu Description: Ubuntu 20.04.x LTS Release: 20.04 Codename: focal注意虽然其他Ubuntu版本也可能安装成功但官方仅对20.04提供完整支持使用其他版本可能导致依赖问题。1.2 基础软件包更新在安装ROS前建议先更新系统已有软件包sudo apt update sudo apt upgrade -y这个步骤经常被忽略但能解决很多后续的依赖冲突问题。更新完成后建议重启系统sudo reboot1.3 必备工具安装ROS安装过程中需要用到一些工具建议提前安装sudo apt install -y curl git python3-pip这些工具将用于密钥管理、源码克隆和Python包管理。特别是curl在后续设置密钥时会用到。2. 软件源配置与镜像优化国内用户安装ROS最大的障碍就是网络连接问题。本节将详细介绍如何配置国内镜像源大幅提升安装速度和成功率。2.1 Ubuntu主源配置首先确保系统已启用所有必要的软件仓库sudo add-apt-repository deb http://archive.ubuntu.com/ubuntu $(lsb_release -sc) main restricted universe multiverse也可以通过图形界面配置打开软件和更新应用在Ubuntu软件选项卡下勾选所有四个仓库选项点击关闭并重新加载软件包信息2.2 ROS镜像源设置官方ROS源在国内访问较慢建议使用清华镜像源sudo sh -c . /etc/lsb-release echo deb http://mirrors.tuna.tsinghua.edu.cn/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list其他可选镜像源如中科大源# 中科大ROS源 sudo sh -c . /etc/lsb-release echo deb http://mirrors.ustc.edu.cn/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list2.3 密钥配置与验证ROS软件包需要验证密钥国内用户常在此步骤失败。以下是优化后的密钥设置方法sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654验证密钥是否添加成功apt-key list | grep ROS Builder预期应看到类似输出pub rsa2048 2020-05-23 [SC] [有效至2025-05-21] C1CF 6E31 E6BA DE88 68B1 72B4 F42E D6FB AB17 C654 uid [ 未知 ] ROS Builder rosbuildros.org常见问题如果密钥服务器无法连接可以尝试更换为hkp://pgp.mit.edu:80或hkp://keyserver.ubuntu.com:113713. ROS Noetic完整安装3.1 桌面完整版安装推荐安装桌面完整版(Desktop-Full)包含ROS、rqt、rviz等常用工具sudo apt update sudo apt install -y ros-noetic-desktop-full安装过程可能需要15-30分钟取决于网络速度。如果中途失败可以尝试sudo apt --fix-broken install然后重新运行安装命令。3.2 基础依赖安装安装构建ROS包所需的工具和依赖sudo apt install -y python3-rosdep python3-rosinstall python3-rosinstall-generator python3-wstool build-essential3.3 rosdep初始化rosdep是管理ROS依赖的重要工具初始化过程常因网络问题失败sudo rosdep init rosdep update国内用户如果遇到rosdep update失败可以尝试以下方法修改hosts文件echo 151.101.84.133 raw.githubusercontent.com | sudo tee -a /etc/hosts使用国内镜像源rosdep update --include-eol-distros --rosdistro noetic提示如果仍然失败可以尝试多次执行rosdep update网络状况不好时可能需要重复5-10次。4. 环境配置与验证4.1 环境变量设置将ROS环境变量添加到bashrc中echo source /opt/ros/noetic/setup.bash ~/.bashrc source ~/.bashrc对于zsh用户echo source /opt/ros/noetic/setup.zsh ~/.zshrc source ~/.zshrc4.2 安装验证验证ROS版本rosversion -d预期输出noetic4.3 基础功能测试启动ROS核心服务roscore在新终端中运行小乌龟模拟器rosrun turtlesim turtlesim_node再开一个终端控制乌龟移动rosrun turtlesim turtle_teleop_key操作提示确保焦点在控制终端使用方向键移动乌龟。5. 常见问题解决方案5.1 安装过程中的典型错误错误现象可能原因解决方案E: Unable to locate package ros-noetic-desktop-full软件源未正确配置检查/etc/apt/sources.list.d/ros-latest.list内容确保格式正确GPG error: NO_PUBKEY F42ED6FBAB17C654密钥未正确添加重新执行密钥添加命令或尝试不同的密钥服务器rosdep update超时网络连接问题修改hosts或使用代理工具ImportError: No module named rospkgPython环境问题执行pip install -U rospkg5.2 ROS环境变量问题如果遇到ROS_DISTRO未设置等环境问题可以手动设置export ROS_DISTROnoetic export ROS_PACKAGE_PATH/opt/ros/noetic/share export PATH$PATH:/opt/ros/noetic/bin5.3 图形界面相关问题如果rviz或gazebo无法启动可能需要安装OpenGL相关驱动sudo apt install -y libgl1-mesa-dev libglu1-mesa-dev对于虚拟机用户可能需要启用3D加速或使用软件渲染export LIBGL_ALWAYS_SOFTWARE16. 进阶配置与优化6.1 创建工作空间建议为开发项目创建独立的工作空间mkdir -p ~/catkin_ws/src cd ~/catkin_ws/ catkin_make source devel/setup.bash将此命令添加到bashrc中echo source ~/catkin_ws/devel/setup.bash ~/.bashrc6.2 多版本ROS共存如果需要同时使用多个ROS版本可以通过以下方式切换# 切换到Noetic source /opt/ros/noetic/setup.bash # 切换到其他版本 source /opt/ros/melodic/setup.bash6.3 性能优化建议对于资源有限的开发板可以安装精简版sudo apt install ros-noetic-ros-base关闭不必要的可视化工具可以节省资源export ROS_NOETIC_IGNORE_GUI17. 后续学习建议成功安装ROS只是第一步建议从以下资源开始学习官方教程roscd turtlesim查看示例代码交互式学习安装ros-noetic-ros-tutorials包社区资源ROS Wiki和Stack Overflow上的中文讨论遇到问题时记住三个调试命令rostopic list # 查看当前话题 rosnode list # 查看运行中的节点 rqt_graph # 可视化节点关系
