虚拟机Ubuntu环境下Gazebo点击插入后添加路径无响应问题

AI 小北

2026-9-23

问题界面截图

可按以下步骤排查修复：

检查虚拟机3D加速配置
Gazebo高度依赖OpenGL渲染，虚拟机默认3D加速兼容问题是该场景下崩溃的最常见诱因。先关闭虚拟机，在虚拟机管理软件（VMware/VirtualBox）的显示设置中关闭3D加速，重启后再次尝试添加路径测试。如果恢复正常，后续需要3D加速功能时，安装对应虚拟机工具的最新版本（VirtualBox安装Guest Additions、VMware安装完整版VMware Tools），同时升级主机显卡驱动即可。
调整虚拟机资源分配
添加路径时Gazebo会全量扫描路径下的所有模型文件，资源不足会直接导致无响应。建议给虚拟机分配至少4核CPU、8GB运行内存、2GB显存，路径下包含大量模型时可适当调高配置。另外尽量不要一次性添加包含数千个模型的根目录，拆分添加子目录可大幅降低单次扫描负载。
修复Gazebo版本或配置问题
11.10.0以下版本的Gazebo存在多个路径扫描相关的已知崩溃bug，可执行gazebo --version查看当前版本，过低则升级到最新稳定版即可。也可以尝试删除Gazebo本地配置文件重置设置：
```
rm ~/.gazebo/gui.ini
```
重启Gazebo后会自动生成默认配置，排除配置异常导致的崩溃。
排除共享文件夹权限问题
如果你添加的路径是主机和虚拟机的共享目录，权限不足会导致扫描时卡住，可将模型文件拷贝到虚拟机本地磁盘后再尝试添加路径，或者调高共享文件夹的读写权限。