Ubuntu 18.04 安装 ROS Melodic 全流程实战手册国内镜像优化版在机器人开发领域ROSRobot Operating System已成为事实上的标准框架。对于初次接触ROS的开发者而言安装过程往往成为第一道门槛——尤其是国内用户常因网络问题遭遇各种报错。本文将手把手带你完成从系统配置到验证测试的全流程特别针对国内网络环境优化了镜像源配置和依赖管理方案。1. 系统准备与环境配置在开始安装ROS之前需要确保系统满足基本要求并完成必要的准备工作。Ubuntu 18.04 LTSBionic Beaver是官方推荐运行ROS Melodic的操作系统版本。首先更新系统软件包索引并升级现有软件sudo apt update sudo apt upgrade -y接下来配置系统允许安装restricted、universe和multiverse软件仓库打开软件和更新设置在Ubuntu软件选项卡中确保勾选所有主要组件仓库点击关闭后等待自动刷新建议操作前创建系统快照可通过Timeshift等工具备份当前系统状态以便在出现问题时快速恢复。2. 镜像源配置与密钥设置国内用户直接使用官方源通常会导致下载速度极慢甚至失败。以下提供三种主流国内镜像源配置方案镜像源配置命令清华大学sudo sh -c . /etc/lsb-release echo deb https://mirrors.tuna.tsinghua.edu.cn/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list中科大sudo sh -c . /etc/lsb-release echo deb https://mirrors.ustc.edu.cn/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list阿里云sudo sh -c . /etc/lsb-release echo deb https://mirrors.aliyun.com/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list设置完成后需要添加ROS软件包的GPG密钥sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654验证密钥是否添加成功apt-key list | grep ROS Builder3. ROS核心组件安装更新软件包索引后可以选择安装不同版本的ROS套件桌面完整版推荐包含ROS、rqt、rviz、机器人通用库等sudo apt install ros-melodic-desktop-full桌面版仅包含ROS核心工具和GUI工具sudo apt install ros-melodic-desktop基础版仅包含ROS核心包和构建工具sudo apt install ros-melodic-ros-base安装过程中常见问题处理遇到Hash校验失败时尝试清理apt缓存sudo apt clean sudo apt update部分包下载失败可尝试单独安装sudo apt install --fix-broken4. 环境配置与依赖管理安装完成后需要设置环境变量将以下命令添加到~/.bashrc文件末尾echo source /opt/ros/melodic/setup.bash ~/.bashrc source ~/.bashrc安装构建工具和依赖管理工具sudo apt install python-rosdep python-rosinstall python-rosinstall-generator python-wstool build-essential初始化rosdep时国内用户通常会遇到连接问题。以下是优化的解决方案修改rosdep源配置文件sudo mkdir -p /etc/ros/rosdep/sources.list.d/ echo yaml https://gitee.com/zhao-xuzuo/rosdistro/raw/master/rosdep/osx-homebrew.yaml osx yaml https://gitee.com/zhao-xuzuo/rosdistro/raw/master/rosdep/base.yaml yaml https://gitee.com/zhao-xuzuo/rosdistro/raw/master/rosdep/python.yaml yaml https://gitee.com/zhao-xuzuo/rosdistro/raw/master/rosdep/ruby.yaml gbpdistro https://gitee.com/zhao-xuzuo/rosdistro/raw/master/releases/fuerte.yaml fuerte | sudo tee /etc/ros/rosdep/sources.list.d/20-default.list修改Python包中的默认URLsudo sed -i s|https://raw.githubusercontent.com/ros/rosdistro/master|https://gitee.com/zhao-xuzuo/rosdistro/raw/master|g /usr/lib/python2.7/dist-packages/rosdep2/*.py sudo sed -i s|https://raw.githubusercontent.com/ros/rosdistro/master|https://gitee.com/zhao-xuzuo/rosdistro/raw/master|g /usr/lib/python2.7/dist-packages/rosdistro/*.py执行更新命令sudo rosdep init rosdep update5. 功能验证与测试完成所有安装步骤后可以通过经典的小乌龟仿真程序验证ROS是否正常工作启动ROS核心服务roscore新终端中启动仿真节点rosrun turtlesim turtlesim_node再开终端启动控制节点rosrun turtlesim turtle_teleop_key成功运行后应该能看到图形界面中出现小乌龟并且可以通过键盘方向键控制其移动。进阶验证方法查看节点关系图rqt_graph查看ROS主题列表rostopic list测试消息发布rostopic pub /turtle1/cmd_vel geometry_msgs/Twist linear: x: 1.0 y: 0.0 z: 0.0 angular: x: 0.0 y: 0.0 z: 1.06. 常见问题深度解决方案问题1rosdep update超时失败除了前述的镜像源替换方案还可以尝试以下方法使用代理模式需确保符合当地法律法规手动下载资源包并本地初始化问题2依赖关系冲突当出现依赖冲突时可以尝试sudo apt --fix-broken install sudo apt autoremove问题3Python版本兼容性问题Ubuntu 18.04默认使用Python 2.7如果需要Python 3支持sudo apt install python3-rosdep python3-rosinstall python3-rosinstall-generator问题4图形界面卡顿可以尝试关闭compiz合成器export LIBGL_ALWAYS_SOFTWARE17. 开发环境优化建议终端配置安装Terminator分屏终端sudo apt install terminator配置ROS环境自动补全sudo apt install bash-completionIDE集成VS Code安装ROS插件Qt Creator配置ROS开发环境效率工具sudo apt install ros-melodic-rqt*网络配置优化sudo sysctl -w net.ipv4.tcp_window_scaling1 sudo sysctl -w net.core.rmem_max2097152 sudo sysctl -w net.core.wmem_max2097152实际使用中发现配置完整开发环境后定期执行以下维护命令可以保持系统稳定sudo apt update sudo apt upgrade rosdep update
Ubuntu 18.04 安装 ROS Melodic 保姆级避坑指南（附清华/中科大源配置）
发布时间：2026/6/7 4:11:29
Ubuntu 18.04 安装 ROS Melodic 全流程实战手册国内镜像优化版在机器人开发领域ROSRobot Operating System已成为事实上的标准框架。对于初次接触ROS的开发者而言安装过程往往成为第一道门槛——尤其是国内用户常因网络问题遭遇各种报错。本文将手把手带你完成从系统配置到验证测试的全流程特别针对国内网络环境优化了镜像源配置和依赖管理方案。1. 系统准备与环境配置在开始安装ROS之前需要确保系统满足基本要求并完成必要的准备工作。Ubuntu 18.04 LTSBionic Beaver是官方推荐运行ROS Melodic的操作系统版本。首先更新系统软件包索引并升级现有软件sudo apt update sudo apt upgrade -y接下来配置系统允许安装restricted、universe和multiverse软件仓库打开软件和更新设置在Ubuntu软件选项卡中确保勾选所有主要组件仓库点击关闭后等待自动刷新建议操作前创建系统快照可通过Timeshift等工具备份当前系统状态以便在出现问题时快速恢复。2. 镜像源配置与密钥设置国内用户直接使用官方源通常会导致下载速度极慢甚至失败。以下提供三种主流国内镜像源配置方案镜像源配置命令清华大学sudo sh -c . /etc/lsb-release echo deb https://mirrors.tuna.tsinghua.edu.cn/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list中科大sudo sh -c . /etc/lsb-release echo deb https://mirrors.ustc.edu.cn/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list阿里云sudo sh -c . /etc/lsb-release echo deb https://mirrors.aliyun.com/ros/ubuntu/ $DISTRIB_CODENAME main /etc/apt/sources.list.d/ros-latest.list设置完成后需要添加ROS软件包的GPG密钥sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv-key C1CF6E31E6BADE8868B172B4F42ED6FBAB17C654验证密钥是否添加成功apt-key list | grep ROS Builder3. ROS核心组件安装更新软件包索引后可以选择安装不同版本的ROS套件桌面完整版推荐包含ROS、rqt、rviz、机器人通用库等sudo apt install ros-melodic-desktop-full桌面版仅包含ROS核心工具和GUI工具sudo apt install ros-melodic-desktop基础版仅包含ROS核心包和构建工具sudo apt install ros-melodic-ros-base安装过程中常见问题处理遇到Hash校验失败时尝试清理apt缓存sudo apt clean sudo apt update部分包下载失败可尝试单独安装sudo apt install --fix-broken4. 环境配置与依赖管理安装完成后需要设置环境变量将以下命令添加到~/.bashrc文件末尾echo source /opt/ros/melodic/setup.bash ~/.bashrc source ~/.bashrc安装构建工具和依赖管理工具sudo apt install python-rosdep python-rosinstall python-rosinstall-generator python-wstool build-essential初始化rosdep时国内用户通常会遇到连接问题。以下是优化的解决方案修改rosdep源配置文件sudo mkdir -p /etc/ros/rosdep/sources.list.d/ echo yaml https://gitee.com/zhao-xuzuo/rosdistro/raw/master/rosdep/osx-homebrew.yaml osx yaml https://gitee.com/zhao-xuzuo/rosdistro/raw/master/rosdep/base.yaml yaml https://gitee.com/zhao-xuzuo/rosdistro/raw/master/rosdep/python.yaml yaml https://gitee.com/zhao-xuzuo/rosdistro/raw/master/rosdep/ruby.yaml gbpdistro https://gitee.com/zhao-xuzuo/rosdistro/raw/master/releases/fuerte.yaml fuerte | sudo tee /etc/ros/rosdep/sources.list.d/20-default.list修改Python包中的默认URLsudo sed -i s|https://raw.githubusercontent.com/ros/rosdistro/master|https://gitee.com/zhao-xuzuo/rosdistro/raw/master|g /usr/lib/python2.7/dist-packages/rosdep2/*.py sudo sed -i s|https://raw.githubusercontent.com/ros/rosdistro/master|https://gitee.com/zhao-xuzuo/rosdistro/raw/master|g /usr/lib/python2.7/dist-packages/rosdistro/*.py执行更新命令sudo rosdep init rosdep update5. 功能验证与测试完成所有安装步骤后可以通过经典的小乌龟仿真程序验证ROS是否正常工作启动ROS核心服务roscore新终端中启动仿真节点rosrun turtlesim turtlesim_node再开终端启动控制节点rosrun turtlesim turtle_teleop_key成功运行后应该能看到图形界面中出现小乌龟并且可以通过键盘方向键控制其移动。进阶验证方法查看节点关系图rqt_graph查看ROS主题列表rostopic list测试消息发布rostopic pub /turtle1/cmd_vel geometry_msgs/Twist linear: x: 1.0 y: 0.0 z: 0.0 angular: x: 0.0 y: 0.0 z: 1.06. 常见问题深度解决方案问题1rosdep update超时失败除了前述的镜像源替换方案还可以尝试以下方法使用代理模式需确保符合当地法律法规手动下载资源包并本地初始化问题2依赖关系冲突当出现依赖冲突时可以尝试sudo apt --fix-broken install sudo apt autoremove问题3Python版本兼容性问题Ubuntu 18.04默认使用Python 2.7如果需要Python 3支持sudo apt install python3-rosdep python3-rosinstall python3-rosinstall-generator问题4图形界面卡顿可以尝试关闭compiz合成器export LIBGL_ALWAYS_SOFTWARE17. 开发环境优化建议终端配置安装Terminator分屏终端sudo apt install terminator配置ROS环境自动补全sudo apt install bash-completionIDE集成VS Code安装ROS插件Qt Creator配置ROS开发环境效率工具sudo apt install ros-melodic-rqt*网络配置优化sudo sysctl -w net.ipv4.tcp_window_scaling1 sudo sysctl -w net.core.rmem_max2097152 sudo sysctl -w net.core.wmem_max2097152实际使用中发现配置完整开发环境后定期执行以下维护命令可以保持系统稳定sudo apt update sudo apt upgrade rosdep update
