Windows下使用VirtualBox搭建ROS开发环境完整指南

1. 项目概述

在机器人开发领域，ROS（Robot Operating System）已成为事实上的标准框架。但对于刚接触ROS的开发者来说，最头疼的问题往往不是ROS本身的学习曲线，而是开发环境的搭建过程。特别是在Windows系统上直接安装ROS会遇到各种兼容性问题，这也是为什么我们需要通过VirtualBox虚拟机来创建Ubuntu系统作为ROS开发环境。

我最近刚完成一个机器人视觉项目，过程中完整走了一遍从零搭建ROS开发环境的流程。这里把我的实操步骤和踩过的坑都记录下来，特别适合以下人群参考：

• 机器人相关专业的在校学生
• 刚接触ROS的开发者
• 需要在Windows系统上开发ROS程序的技术人员
• 想尝试ROS但不想影响现有系统的爱好者

2. 环境准备与虚拟机创建

2.1 VirtualBox安装与配置

首先需要下载并安装VirtualBox，这是Oracle提供的免费开源虚拟机软件。我推荐使用最新稳定版（目前是7.0.x系列），因为老版本可能存在一些已知问题。

安装时需要注意：

1. 确保勾选"创建桌面快捷方式"和"注册文件关联"
2. 安装过程中会短暂断开网络连接，这是正常现象
3. 安装完成后建议重启电脑

提示：如果安装过程中出现"严重错误"提示，通常是系统缺少必要的运行库。可以尝试安装最新版的Visual C++ Redistributable后再试。

2.2 Ubuntu镜像选择与下载

对于ROS开发，Ubuntu版本的选择很关键。因为不同版本的ROS对Ubuntu有特定要求：

• ROS Noetic：推荐Ubuntu 20.04
• ROS Melodic：推荐Ubuntu 18.04
• ROS Humble：推荐Ubuntu 22.04

我选择的是Ubuntu 22.04 LTS版本，对应的ROS版本是Humble Hawksbill。这个组合目前最稳定，社区支持也最好。

下载镜像时建议从官方镜像站获取：

https://releases.ubuntu.com/22.04/

选择"ubuntu-22.04.3-desktop-amd64.iso"这个文件（约4GB）。

2.3 创建虚拟机实例

在VirtualBox中点击"新建"，按以下参数配置：

• 名称：ROS_Dev（可自定义）
• 类型：Linux
• 版本：Ubuntu (64-bit)
• 内存大小：建议至少4096MB（4GB）
• 硬盘：创建虚拟硬盘，建议40GB以上，选择VDI格式，动态分配

创建完成后，还需要进行一些关键设置：

1. 系统 → 处理器：分配至少2个CPU核心
2. 显示 → 显存：调到128MB
3. 存储 → 控制器IDE：挂载下载的Ubuntu ISO镜像
4. 网络 → 连接方式：桥接网卡（方便主机与虚拟机通信）

3. Ubuntu系统安装与基础配置

3.1 Ubuntu安装过程

启动虚拟机后，按照以下步骤安装Ubuntu：

1. 选择"Install Ubuntu"
2. 语言选择English（后续开发时可以减少编码问题）
3. 键盘布局保持默认
4. 安装类型选择"Normal installation"
5. 分区选择"Erase disk and install Ubuntu"（不用担心，这只会影响虚拟硬盘）
6. 时区选择"Shanghai"
7. 设置用户名和密码（建议密码不要太复杂，后续经常要用到）

安装过程大约需要20-30分钟，完成后会提示重启。重启前记得在VirtualBox设置中移除安装镜像，否则会再次进入安装界面。

3.2 基础系统配置

首次登录后，建议立即进行以下配置：

1. 更新软件源：

sudo apt update && sudo apt upgrade -y

2. 安装增强功能（提供更好的显示效果和剪贴板共享）：

sudo apt install -y build-essential dkms linux-headers-$(uname -r)

然后在VirtualBox菜单选择"设备" → "安装增强功能"，挂载后运行：

sudo ./VBoxLinuxAdditions.run

3. 配置共享文件夹（方便主机与虚拟机交换文件）：

sudo adduser $USER vboxsf

然后在VirtualBox设置中添加共享文件夹，指定主机路径和挂载点（如/home/yourname/shared）

4. 安装必要工具：

sudo apt install -y git curl wget terminator

4. ROS开发环境搭建

4.1 ROS安装

按照官方推荐的方式安装ROS Humble：

1. 设置软件源：

sudo apt install -y software-properties-common sudo add-apt-repository universe

2. 添加ROS仓库：

sudo apt install -y curl sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(. /etc/os-release && echo $UBUNTU_CODENAME) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null

3. 安装ROS基础包：

sudo apt update sudo apt install -y ros-humble-desktop

4. 设置环境变量：

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

4.2 开发工具配置

1. 安装colcon构建工具：

sudo apt install -y python3-colcon-common-extensions

2. 安装ROS开发工具：

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

3. 创建工作空间：

mkdir -p ~/ros2_ws/src cd ~/ros2_ws colcon build

4.3 VSCode配置

1. 安装VSCode：

sudo apt install -y wget wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/ sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list' sudo apt update sudo apt install -y code

2. 安装ROS插件：

• 打开VSCode
• 进入Extensions（Ctrl+Shift+X）
• 搜索并安装"ROS"和"Python"插件

3. 配置工作区：

code ~/ros2_ws

在VSCode中打开终端（Ctrl+`），就可以直接在IDE中开发ROS程序了。

5. 常见问题与解决方案

5.1 虚拟机性能优化

问题：虚拟机运行卡顿 解决方案：

1. 在VirtualBox设置中启用3D加速
2. 分配更多CPU核心（不超过主机核心数的一半）
3. 增加显存（最多256MB）
4. 在Ubuntu中安装轻量级桌面环境（如Xfce）

5.2 ROS安装问题

问题：rosdep初始化失败 解决方案：

sudo rm -rf /etc/ros/rosdep/sources.list.d/20-default.list sudo rosdep init rosdep update

问题：找不到ROS命令 解决方案：

source /opt/ros/humble/setup.bash

5.3 网络连接问题

问题：虚拟机无法上网 解决方案：

1. 检查VirtualBox网络设置是否为"桥接模式"
2. 在Ubuntu中重启网络服务：

sudo service network-manager restart

问题：主机与虚拟机无法ping通 解决方案：

1. 确保两者在同一网段
2. 检查Ubuntu防火墙设置：

sudo ufw disable

6. 开发环境验证

6.1 基础功能测试

1. 启动ROS核心：

roscore

应该看到类似输出：

... logging to /home/username/.ros/log/xxxxx started core service [/rosout]

2. 运行小海龟示例：

ros2 run turtlesim turtlesim_node

另开终端运行：

ros2 run turtlesim turtle_teleop_key

此时应该能用键盘控制小海龟移动。

6.2 VSCode开发测试

1. 在VSCode中创建ROS包：

cd ~/ros2_ws/src ros2 pkg create --build-type ament_python my_first_package

2. 编写简单发布者： 编辑my_first_package/my_first_package/publisher.py：

import rclpy from rclpy.node import Node from std_msgs.msg import String class MinimalPublisher(Node): def __init__(self): super().__init__('minimal_publisher') self.publisher_ = self.create_publisher(String, 'topic', 10) timer_period = 0.5 self.timer = self.create_timer(timer_period, self.timer_callback) self.i = 0 def timer_callback(self): msg = String() msg.data = 'Hello World: %d' % self.i self.publisher_.publish(msg) self.get_logger().info('Publishing: "%s"' % msg.data) self.i += 1 def main(args=None): rclpy.init(args=args) minimal_publisher = MinimalPublisher() rclpy.spin(minimal_publisher) minimal_publisher.destroy_node() rclpy.shutdown() if __name__ == '__main__': main()

3. 编译并运行：

cd ~/ros2_ws colcon build --packages-select my_first_package source install/setup.bash ros2 run my_first_package publisher

应该能看到不断输出的"Hello World"消息。

7. 进阶配置与优化

7.1 使用鱼香ROS一键安装

对于想快速搭建环境的用户，可以使用国内开发者维护的"鱼香ROS"一键安装脚本：

wget http://fishros.com/install -O fishros && . fishros

按照提示选择安装ROS和相关工具。

7.2 配置ROS工作区自动补全

在~/.bashrc中添加：

source /usr/share/colcon_argcomplete/hook/colcon-argcomplete.bash

7.3 使用Docker容器开发

对于需要隔离环境的项目，可以考虑使用ROS Docker镜像：

sudo apt install -y docker.io sudo usermod -aG docker $USER docker pull osrf/ros:humble-desktop

7.4 性能监控工具

安装htop监控系统资源：

sudo apt install -y htop

运行：

htop

在实际开发中，我发现这套环境配置对于大多数ROS开发任务已经足够。特别是配合VSCode的ROS插件，可以大大提高开发效率。对于需要图形加速的应用（如Gazebo仿真），可以考虑使用GPU直通技术，但这需要更复杂的配置。