Isaac Sim 安装与环境要求
二、安装与环境要求
硬件与系统要求
| 项目 | 要求 | 说明 |
|---|
| 显卡 | NVIDIA RTX 系列，需支持光追 | 显存需求随场景复杂度上升，具体型号与显存门槛以官方发布说明为准 |
| 驱动 | 有最低驱动版本要求 | 版本对不上会直接启动失败，务必查官方安装文档 |
| 操作系统 | 官方支持的 Ubuntu 版本 | Windows 也提供支持，但生产与集群通常用 Linux |
| 内存与磁盘 | 内存建议 32 GB 以上，磁盘预留充足空间 | 资产包与缓存体积很大 |
| 无 GPU 服务器 | 不可用 | 纯 CPU 服务器无法运行，这一点与 MuJoCo 差别很大 |
安装方式
- 确认显卡驱动版本满足要求，用生产版本的驱动而不是最新的测试版。
- 选择安装方式：官方提供独立安装包、pip 包、Docker 容器等多种途径。容器方式在服务器与集群上最省事，也最容易和 ROS2 环境隔离。
- 安装完成后先跑一次官方示例场景，确认渲染正常、物理能推进。
- 如果要接 ROS2，确认所装 Isaac Sim 版本支持的 ROS2 发行版与系统里的一致，再启用 ROS2 Bridge 扩展。
- 离线环境需要提前下载资产包并放到本地，否则运行时会卡在拉取资产上。
# 以容器方式为例，具体镜像名与参数以官方文档为准
docker pull nvcr.io/nvidia/isaac-sim:latest
docker run --gpus all --rm -it \
--network host \
-e ACCEPT_EULA=Y \
-e PRIVACY_CONSENT=Y \
-v ~/isaac_cache:/isaac-sim/.cache \
-v ~/projects:/projects \
nvcr.io/nvidia/isaac-sim:latest
容器里跑图形界面需要把显示相关环境变量透传进去；如果只是批处理出数据，用无头模式更省资源。
常见报错排查
| 报错 / 现象 | 原因 | 处理 |
|---|
| 启动即退出，日志提示驱动或 Vulkan 相关 | 驱动版本不满足要求，或缺图形库 | 按官方要求升级驱动，安装必要的图形运行库 |
| 显存不足或运行中崩溃 | 场景太大、纹理分辨率过高、并行环境过多 | 减少并行环境数量，降低渲染分辨率与纹理尺寸 |
| 扩展加载失败 | 扩展版本与主体版本不匹配 | 使用随版本发布的扩展，不要混装 |
| 资产一直在下载或超时 | 网络受限 | 提前把资产下载到本地并配置本地资产根路径 |
| ROS2 话题不通 | Bridge 扩展未启用，或 ROS2 版本不匹配 | 检查扩展是否启用，确认发行版对应关系 |
| 容器内看不到画面 | 显示环境变量未透传 | 用无头模式，或正确配置 X11 / 虚拟显示 |
| 物理表现很「飘」 | 质量与惯性参数是默认值，子步进设置不当 | 按真实参数设置质量、惯性与摩擦，调整子步数 |
