简介这份PDF教程面向ROS机器人开发初学者与在校学生聚焦机器人学习环境搭建中最基础也最容易卡壳的一环——Ubuntu系统的安装。内容从Ubuntu镜像的下载与位数选择讲起逐步延伸到虚拟机软件的安装配置、虚拟机创建、操作系统类型与版本选择、存储位置与硬盘容量规划、网络与硬件资源分配并进一步衔接ROS的安装与环境搭建帮助读者打通从零到可开发状态的完整链路。资源包共1个PDF文件大小约13.36MB以图文步骤形式呈现关键节点配有操作提示如虚拟机名称避免中文、镜像版本务必选择Ubuntu 64位、硬盘至少分配25GB、UEFI选项与后续分区的关系等便于对照操作与排错。目前已有276人学习适合希望系统入门ROS机器人开发、需要一份可跟随的环境搭建参考的学习者。1. 机器人开发环境第一关为什么 Ubuntu 装不对后面全白费很多人拿到 ROS 机器人学习课程第一反应是直奔代码和算法结果卡在第一步——Ubuntu 系统装不上。这不是个别现象。我见过太多人虚拟机建好了、镜像下完了启动后黑屏、卡在分区界面、或者装完发现网络不通最后连 ROS 都没跑起来就放弃了。问题出在哪出在大多数人把“装 Ubuntu”当成装个软件点下一步就行但机器人开发对系统环境有硬性要求64 位架构、UEFI 引导、合理的磁盘分区、稳定的网络配置任何一个环节选错后面 ROS 的安装和运行都会出玄学问题。这份课程第二章的内容就是专门解决这个“第一公里”的。它不讲虚的从下载镜像到虚拟机配置再到 Ubuntu 安装每一步都标了“这里不能选错”的提示。适合谁适合刚接触 ROS 机器人开发、需要在本地搭建 Linux 环境的学生和工程师尤其是那些用 Windows 主机、想通过虚拟机跑 Ubuntu 的人。如果你已经能熟练装系统这篇可以跳过如果你装完 Ubuntu 发现 ROS 装不上、网络连不通、磁盘不够用那大概率是安装阶段埋的坑。2. 虚拟机选型与镜像准备VMware 配置里的五个关键决策2.1 为什么机器人开发首选虚拟机而不是双系统ROS 机器人开发需要 Linux 环境但大多数人的主力机是 Windows。双系统切换麻烦WSL 对硬件接口和图形化工具支持有限虚拟机是折中方案里最稳的。VMware 和 VirtualBox 都能用但课程里选的是 VMware原因很实际VMware 对 USB 设备透传、网络桥接、共享文件夹的支持更成熟后面接机器人硬件、跑 RViz 可视化的时候少折腾。虚拟机的好处是快照——装 ROS 之前打个快照装崩了一键回滚这是双系统给不了的后悔药。代价是性能损耗所以资源分配要合理后面会讲具体参数。2.2 镜像下载与版本选择64 位是硬门槛Ubuntu 镜像从官网下载选桌面版Desktop不要选服务器版。机器人开发需要图形界面跑 RViz、Gazebo 这些工具服务器版没有桌面环境后面还得自己装纯属找麻烦。版本方面ROS 每个发行版对应特定的 Ubuntu 版本比如 ROS Noetic 对应 Ubuntu 20.04ROS 2 Humble 对应 Ubuntu 22.04。课程里没有指定具体版本号但原则是先确定你要学哪个 ROS 版本再倒推 Ubuntu 版本。架构必须选 64 位32 位在机器人开发里已经淘汰了很多库根本不支持。下载下来的文件是.iso格式通常 2-4 GB放在一个路径里没有中文和空格的文件夹里比如D:\vm\iso\别放桌面。2.3 VMware 安装两个勾选项决定后续体验VMware Workstation 安装本身不复杂但有两个地方课程里专门标了“建议全部勾选”和“全部不要勾选”。具体来说安装路径不要出现中文字符这是铁律中文路径会导致虚拟机启动时报错而且报错信息往往看不出是路径问题。安装过程中的“增强型键盘驱动”建议勾选不然后面 Ubuntu 里键盘映射可能出问题。另一个是“启动时检查更新”建议取消否则每次打开 VMware 都弹更新提示浪费时间。安装完成后不需要立即重启但建议重启一次再创建虚拟机避免驱动加载不完整。2.4 创建虚拟机名称、位置、类型、UEFI 四个参数打开 VMware 新建虚拟机选“自定义高级”不要选典型。典型模式会跳过很多关键设置后面改起来更麻烦。操作系统类型选 Linux版本选 Ubuntu 64 位——这里课程里反复强调“如果不选后续步骤会出问题”因为选错版本会导致 VMware 用错误的虚拟硬件配置最直接的影响是 UEFI 选项不可用。虚拟机名称用英文不要用中文比如ros-ubuntu就行。存储位置选一个专门的文件夹比如D:\vm\ros-ubuntu\不要放 C 盘根目录或桌面原因有两个一是虚拟机文件会越来越大C 盘空间紧张会影响宿主机二是桌面路径可能包含中文用户名又是中文路径问题。处理器分配看宿主机配置一般给 2 核 2 线程起步内存至少 4 GB建议 8 GB。网络类型选 NAT后面可以改成桥接NAT 的好处是虚拟机共享宿主机网络不用额外配置就能上网。磁盘容量课程里写“至少 25 GB建议尽可能大”我的经验是直接给 60-80 GB选“将虚拟磁盘拆分成多个文件”不影响性能反而方便迁移。磁盘类型选 SCSI 或 NVMe 都行NVMe 性能略好但兼容性要求高SCSI 更稳。最关键的一步在“自定义硬件”里把“引导选项”中的 UEFI 勾上。课程里写“这个一定要选择 UEFI会涉及到后期的分区”原因是 UEFI 引导对应 GPT 分区表传统 BIOS 对应 MBR。ROS 开发中有些工具和库对分区表有要求而且 UEFI 启动更快。如果前面操作系统版本没选 Ubuntu 64 位这里 UEFI 选项是灰的选不了所以前面那步不能错。2.5 加载 ISO 镜像与首次启动在虚拟机设置里找到 CD/DVD选择“使用 ISO 映像文件”浏览到之前下载的.iso文件。课程里写“这里加载的就是我们下载的 ISO 镜像”确认路径没错。网络适配器保持 NAT显示器配置里把“加速 3D 图形”勾上后面跑 Gazebo 会用到。声卡和打印机可以移除不影响系统运行还能省资源。启动虚拟机如果看到 Ubuntu 的加载界面和安装选项说明前面的配置都对了。如果黑屏或者报错优先检查 ISO 路径是否有中文、UEFI 是否勾选、操作系统版本是否选对。3. Ubuntu 安装过程分区、用户与网络配置的实操细节3.1 安装引导与语言选择虚拟机启动后进入 Ubuntu 安装界面左侧是语言列表。课程里写“可以用英文顶端也可以用中文末尾”我的建议是选英文。原因不是英文更好而是中文环境下有些终端输出和日志会乱码排查问题时多一层干扰。选完语言后有两个按钮Try Ubuntu 和 Install Ubuntu。课程里特别提醒“不着急点击 Install Ubuntu”先点 Try Ubuntu 进 Live 环境检查分辨率、网络、键盘是否正常。进去之后右上角倒三角菜单里点 Settings找到 Displays把分辨率调到 1920×1080课程里写“一般 1920×1080 即可”。这一步不做的话安装界面可能显示不全按钮点不到。3.2 安装类型与更新选项确认 Live 环境没问题后双击桌面上的 Install Ubuntu 图标开始安装。键盘布局默认即可语言选 English。到了“Updates and other software”这一步课程里写“千万不能勾选”指的是“Download updates while installing Ubuntu”和“Install third-party software for graphics and Wi-Fi hardware”。不勾的原因有两个一是安装时下载更新会拖慢进度而且网络不稳时可能卡住二是第三方驱动在虚拟机里不一定需要后面可以手动装。勾了反而容易在安装过程中报错。直接点继续。3.3 分区方案为什么必须选“其他选项”这是整个安装过程中最容易翻车的地方。课程里写“一定选择其他选项”不要选“清除整个磁盘并安装 Ubuntu”。原因很简单虚拟机磁盘虽然是一块虚拟盘但选“清除整个磁盘”会自动分区不会创建独立的/home分区。ROS 开发中/home分区独立的好处是重装系统时用户数据和 ROS 工作空间可以保留。选“其他选项”进入手动分区界面需要自己创建分区表。具体分区方案以 60 GB 虚拟磁盘为例挂载点大小类型说明EFI 系统分区512 MB主分区UEFI 引导必须格式 FAT32/30 GB逻辑分区系统根目录格式 ext4/home剩余空间逻辑分区用户数据格式 ext4swap4-8 GB逻辑分区交换空间内存的 1-2 倍如果磁盘只有 25 GB可以只分/和 swap但/home独立的好处后面会体现。分区时注意EFI 分区要选“EFI System Partition”类型不要选错。课程里没有给出具体分区数值但强调了 UEFI 和分区的关联说明分区方案和引导模式是绑定的。3.4 用户创建与安装完成分区确认后设置时区选 Shanghai、用户名、密码。用户名用英文小写不要用中文或大写字母否则终端里路径会出问题。密码建议设简单点虚拟机里不需要太复杂后面 sudo 操作频繁密码太复杂浪费时间。勾选“Log in automatically”可以免密码登录看个人习惯。安装过程大约 10-20 分钟取决于磁盘性能。安装完成后提示重启重启前记得在虚拟机设置里把 CD/DVD 的 ISO 映像断开否则又会从 ISO 启动。3.5 安装后必做的三件事重启进入系统后第一件事是确认网络。打开终端运行ping -c 4 www.baidu.com如果通说明 NAT 网络正常。第二件事是更新软件源运行sudo apt update sudo apt upgrade -y这一步会花几分钟但后面装 ROS 依赖时能少很多麻烦。第三件事是安装 VMware Tools在 VMware 菜单里选“安装 VMware Tools”然后在 Ubuntu 里挂载并运行安装脚本作用是支持共享文件夹、拖拽文件、自动调整分辨率。课程里没有展开这部分但这是虚拟机使用的标配不装的话宿主机和虚拟机之间传文件很痛苦。# 更新软件源并升级已安装的包 sudo apt update sudo apt upgrade -y # 安装 VMware Tools 依赖如果使用 open-vm-tools sudo apt install open-vm-tools open-vm-tools-desktop -y # 检查网络连通性 ping -c 4 www.baidu.com # 查看磁盘分区情况确认 /home 是否独立挂载 df -h这几条命令是装完系统后的标准动作。apt update刷新软件源索引apt upgrade升级已有包open-vm-tools提供虚拟机增强功能df -h用来确认分区挂载是否符合预期。如果df -h输出里看不到独立的/home挂载点说明分区时没分出来后面重装系统数据会丢。4. 避坑与排查安装 Ubuntu 时最容易翻车的五个地方4.1 虚拟机启动黑屏或卡在引导界面现象VMware 启动虚拟机后屏幕全黑或者卡在Booting from Hard Disk不动。原因通常是 ISO 镜像没加载、UEFI 没勾选、或者操作系统版本选错导致虚拟硬件不兼容。解决关机检查虚拟机设置里 CD/DVD 是否指向正确的 ISO 文件引导选项里 UEFI 是否勾选操作系统版本是否为 Ubuntu 64 位。如果都对了还是黑屏把虚拟机磁盘删掉重建重建时严格按 2.4 节的参数走一遍。4.2 安装界面显示不全按钮点不到现象Ubuntu 安装向导的窗口比虚拟机屏幕大底部的“继续”按钮看不到。原因是没有在 Live 环境里调整分辨率。解决在安装界面按AltF7可以拖动窗口但更彻底的办法是重启虚拟机进 Try Ubuntu 后先调分辨率到 1920×1080再开始安装。如果分辨率选项里没有 1920×1080说明 VMware Tools 没装或者 3D 加速没开回虚拟机设置里勾上“加速 3D 图形”。4.3 分区时找不到 EFI 分区选项现象手动分区界面里创建分区时类型下拉菜单里没有“EFI System Partition”。原因是虚拟机引导模式不是 UEFI或者操作系统版本没选 Ubuntu 64 位。解决关机进虚拟机设置确认引导选项里 UEFI 已勾选。如果 UEFI 选项是灰的说明操作系统版本选错了改成 Ubuntu 64 位后再试。这个坑课程里专门标了“这个一定要选择 UEFI”不是随便说说的。4.4 安装完成后无法上网现象进入 Ubuntu 桌面后浏览器打不开网页终端里ping不通。原因通常是网络适配器没配置好或者 NAT 服务没启动。解决在 VMware 菜单里选“编辑”-“虚拟网络编辑器”确认 VMnet8NAT 模式存在且已启用。然后在 Ubuntu 右上角网络图标里确认“有线连接”已打开。如果还是不行把网络适配器改成桥接模式试试桥接模式下虚拟机会从路由器获取独立 IP但需要宿主机网络允许。4.5 磁盘空间不够ROS 装到一半失败现象安装 ROS 时提示No space left on device或者系统运行越来越慢。原因是虚拟机磁盘初始分配太小课程里写“至少 25 GB”但实际 ROS 完整安装加上 Gazebo、RViz 等工具25 GB 很快用完。解决如果还没装 ROS关机后在 VMware 设置里扩展磁盘容量然后进 Ubuntu 用gparted扩展分区。如果已经装了一部分建议删掉重装磁盘扩容后分区调整比较麻烦。我的习惯是一开始就给 80 GB省得后面折腾。5. 装完系统之后验证环境与衔接 ROS 安装的关键检查系统装完不是终点只是起点。在装 ROS 之前有几个检查项必须过一遍否则 ROS 装上了也跑不起来。第一个是确认系统架构终端里运行uname -m输出必须是x86_64如果是i686说明装成了 32 位得重装。第二个是确认网络和 DNS运行sudo apt update不报错说明软件源可达。第三个是确认磁盘空间df -h看/和/home的可用空间建议至少留 20 GB 给 ROS 和后续工作空间。# 确认系统架构 uname -m # 确认 Ubuntu 版本后面选 ROS 版本要用 lsb_release -a # 确认磁盘可用空间 df -h # 确认内存和交换空间 free -h # 确认网络和 DNS nslookup github.com这几条命令的输出决定了你后面能装哪个版本的 ROS。lsb_release -a会显示 Ubuntu 版本号比如 20.04 对应 ROS Noetic22.04 对应 ROS 2 Humble。free -h看内存和 swap如果 swap 是 0说明分区时没分 swap后面编译大型 ROS 包可能内存不足。nslookup检查 DNS 解析如果解析不了apt安装 ROS 时会报“无法解析域名”。还有一个容易被忽略的点虚拟机快照。在装 ROS 之前关掉虚拟机在 VMware 里打一个快照命名比如“ubuntu-clean”。后面 ROS 装崩了、配置乱了一键回滚到这个快照比重新装系统快得多。这个习惯我每次搭新环境都会做血泪经验——有一次装 ROS 2 把系统依赖搞崩了没有快照只能重装 Ubuntu一下午没了。从那以后我每次装完系统、装 ROS 之前都强制走一遍快照流程。虚拟机的好处就在这里后悔药随时有。希望帮到你。本文还有配套的精品资源点击获取