环境搭建：安装Isaac Sim、配置Python环境、验证安装、熟悉Omniverse界面与基础操作

在开始AGV小车路径规划仿真之前，搭建一个稳定、可复现的开发环境是整个课程的基础。Isaac Sim 作为 NVIDIA Omniverse 平台上的核心仿真应用，其安装与配置涉及多个层次：底层驱动、Omniverse Launcher、Isaac Sim 应用本体、Python 虚拟环境以及 IDE 调试接口。本章将按照“安装前检查 → 安装部署 → Python 环境配置 → 安装验证 → 界面熟悉”的顺序，系统讲解每一个环节的操作要点与排障方法，帮助你建立一套干净、高效的仿真开发工作台。

2.1 安装前检查：硬件与软件的前置条件

Isaac Sim 是一个基于物理引擎和光线追踪的仿真平台，对硬件有明确要求。在开始安装之前，务必逐项核对以下条件，避免安装过程中途失败或运行时频繁崩溃。

核心原理：分层依赖关系

Isaac Sim 的运行依赖自下而上的四层结构：硬件驱动层（GPU 驱动、CUDA 版本）、系统层（操作系统、显卡固件）、Omniverse 平台层（Launcher、 Nucleus、Cache）、应用层（Isaac Sim 本体及其 Python 扩展包）。任何一层的缺失或版本不匹配，都会导致上层应用无法正常工作。例如，GPU 驱动版本过低会导致 CUDA 初始化失败，进而使 Isaac Sim 在启动时直接崩溃。

判断方法：硬件与系统要求清单

操作流程：安装前检查步骤

1. 打开终端（Windows 使用 CMD 或 PowerShell，Ubuntu 使用 Terminal），执行 nvidia-smi 查看 GPU 型号和驱动版本。
2. 确认驱动版本 ≥ 535。如果低于此版本，请前往 NVIDIA 官网下载对应驱动并更新，更新后重启系统。
3. 检查 Python 版本：执行 python --version。如果未安装 Python 3.10，请从 python.org 下载并安装，安装时勾选“Add Python to PATH”。
4. 检查磁盘空间：确保安装盘（通常是 C 盘或主分区）有至少 30GB 可用空间。

2.2 安装 Isaac Sim：从 Omniverse Launcher 到应用部署

Isaac Sim 的官方推荐安装方式是通过 NVIDIA Omniverse Launcher 进行管理。Launcher 不仅负责下载和更新 Isaac Sim，还提供了 Nucleus（用于资产共享）和 Cache（用于加速加载）等配套工具。

核心原理：Omniverse 生态架构

Omniverse Launcher 是一个桌面应用程序，它充当“应用商店”的角色。通过 Launcher，你可以安装不同版本的 Isaac Sim（如 4.0、4.1、4.2 等），每个版本独立存放，互不干扰。Launcher 还会自动处理依赖项，例如 Vulkan 运行时、RTX 渲染插件等。这种设计使得多版本共存成为可能，方便你后续在不同项目间切换。

操作流程：安装步骤详解

1. 下载 Omniverse Launcher：访问 NVIDIA Omniverse 官网，点击“Download for Windows”或“Download for Linux”，下载对应安装包。
2. 安装 Launcher：双击安装包，按照提示完成安装。安装路径建议保持默认（C:\Users\<用户名>\AppData\Local\ov\pkg），避免后续权限问题。
3. 登录 NVIDIA 账号：启动 Launcher，使用 NVIDIA 账号登录。如果没有账号，需要先注册。
4. 安装 Isaac Sim：在 Launcher 的“Exchange”或“Library”标签页中，找到“Isaac Sim”，点击“Install”。选择版本（建议选择最新的稳定版，如 4.2.0），点击“Install”开始下载。
5. 等待下载与安装：下载大小约为 15-20GB，取决于网络速度，可能需要 30-60 分钟。安装完成后，Launcher 会显示“Launch”按钮。

案例拆解：安装过程中的典型问题

背景：某学员在 Windows 11 系统上安装 Isaac Sim 4.1，下载完成后点击“Launch”却没有任何反应，任务管理器中能看到进程，但窗口不出现。

分析过程：首先检查 GPU 驱动版本，发现为 528.xx，低于要求的 535。其次，检查系统日志（事件查看器 → Windows 日志 → 应用程序），发现报错信息指向 vulkan-1.dll 加载失败。

解决步骤：

1. 升级 GPU 驱动至 551.86 版本，重启系统。
2. 安装 Vulkan Runtime，可从 NVIDIA 官网下载最新版。
3. 重新启动 Isaac Sim，窗口正常显示。

复盘经验：安装前务必先更新驱动，不要依赖 Windows 自动更新。同时，学会查看系统日志是排障的重要技能。

2.3 配置 Python 环境：虚拟环境与 Isaac Sim Python API

Isaac Sim 提供了完整的 Python API，允许你通过脚本控制仿真场景、添加物体、设置传感器、执行路径规划算法。但直接使用系统 Python 会导致依赖冲突，因此必须创建独立的虚拟环境。

核心原理：Python 包与 Isaac Sim 的绑定机制

Isaac Sim 安装后，其 Python 包位于安装目录下的 python 子目录中。该目录包含了所有必要的依赖库（如 torch、numpy、usd-core 等）。你需要将虚拟环境的 site-packages 指向这个目录，或者使用 Isaac Sim 自带的 Python 解释器。推荐做法是：在虚拟环境中安装 isaacsim 包，该包会创建一个指向 Isaac Sim 安装路径的链接。

操作流程：创建虚拟环境并接入 Isaac Sim

# 1. 创建虚拟环境（使用 Python 3.10）
python -m venv isaac_env

# 2. 激活虚拟环境
# Windows:
isaac_env\Scripts\activate
# Ubuntu:
source isaac_env/bin/activate

# 3. 升级 pip
python -m pip install --upgrade pip

# 4. 安装 Isaac Sim Python 包（注意替换路径）
# 找到 Isaac Sim 安装路径，例如：
# C:\Users\<用户名>\AppData\Local\ov\pkg\isaac_sim-2023.1.1
pip install --target=isaac_env\Lib\site-packages ^
  C:\path\to\isaac_sim\python\isaacsim-4.2.0-py3-none-any.whl

# 5. 验证安装
python -c "import isaacsim; print('Isaac Sim Python API 导入成功')"

setx ISAAC_SIM_PATH "C:\Users\<用户名>\AppData\Local\ov\pkg\isaac_sim-2023.1.1"

案例拆解：配置 IDE 调试环境（VS Code）

背景：你希望在 VS Code 中编写和调试 AGV 路径规划脚本，需要让 IDE 识别 Isaac Sim 的 Python 解释器和模块。

操作步骤：

1. 在 VS Code 中打开你的项目文件夹。
2. 按 Ctrl+Shift+P，输入 “Python: Select Interpreter”，选择 isaac_env\Scripts\python.exe。
3. 在项目根目录创建 .vscode/settings.json，添加以下内容：

   {
     "python.autoComplete.extraPaths": [
       "C:/path/to/isaac_sim/python"
     ],
     "python.analysis.extraPaths": [
       "C:/path/to/isaac_sim/python"
     ]
   }

4. 重启 VS Code，此时代码补全和类型提示应该能正常工作。

复盘：配置 IDE 是提升开发效率的关键一步。很多初学者在终端中能运行脚本，但在 IDE 中却报错，原因就是解释器或路径配置不正确。

2.4 验证安装：运行示例场景与基础测试

安装完成后，必须通过实际运行来验证环境是否真正可用。验证分为两个层次：一是启动 Isaac Sim 图形界面，二是通过 Python 脚本控制仿真。

核心原理：验证的层次

第一层验证是 GUI 启动测试，确认渲染引擎、物理引擎和资源加载正常。第二层验证是 Python API 测试，确认你能够通过代码创建场景、添加物体、获取状态数据。只有两层都通过，才能说明环境搭建成功。

操作流程：验证步骤

1. GUI 验证：在 Launcher 中点击“Launch”，等待 Isaac Sim 窗口出现。默认会加载一个空场景或示例场景（如 Warehouse）。
2. Python 验证：在虚拟环境中执行以下脚本：

   from isaacsim import SimulationApp
   # 启动仿真应用（headless 模式为 False 表示显示窗口）
   sim_app = SimulationApp({"headless": False})
   
   # 导入必要的模块
   from isaacsim.core.api import World
   from isaacsim.core.api.objects import DynamicCuboid
   
   # 创建世界
   world = World()
   # 添加一个立方体作为测试物体
   cube = DynamicCuboid(
       prim_path="/World/Cube",
       name="TestCube",
       position=[0, 0, 1.0],
       scale=[0.5, 0.5, 0.5],
       color=[1.0, 0.0, 0.0]
   )
   world.scene.add_default_ground_plane()
   world.reset()
   
   # 运行 10 步仿真
   for i in range(10):
       world.step()
       print(f"Step {i}: Cube position = {cube.get_world_pose()[0]}")
   
   sim_app.close()
   print("验证通过！")
   

3. 观察输出：如果控制台打印出立方体的位置变化（由于重力作用，y 坐标会逐渐减小），说明物理引擎正常工作。

C:\path\to\isaac_sim\python.bat -m pip list | grep isaacsim

2.5 熟悉 Omniverse 界面与基础操作

Isaac Sim 的界面基于 Omniverse 平台，融合了 3D 视口、场景层级、属性面板、内容浏览器等多个功能区域。熟悉这些界面元素是后续高效操作的前提。

核心原理：界面布局与功能分区

操作流程：基础操作练习

1. 导航视口：按住鼠标左键拖动旋转视角，按住鼠标右键拖动平移视角，滚动滚轮缩放。按住 Alt + 鼠标左键可以围绕目标点旋转。
2. 添加物体：在内容浏览器中搜索 “Cube” 或 “Cone”，将其拖拽到视口中。观察场景层级中自动出现对应的 prim。
3. 变换物体：选中物体后，使用工具栏中的移动（W）、旋转（E）、缩放（R）工具进行操作。也可以在属性面板中直接输入数值。
4. 运行仿真：点击工具栏中的播放按钮（▶），观察物体在重力作用下下落。点击暂停（⏸）停止仿真。
5. 保存场景：使用 Ctrl+S 保存为 USD 文件，这是 Omniverse 的标准场景格式。

案例拆解：从零搭建一个简单 AGV 测试场景

背景：为了验证环境是否支持后续的 AGV 路径规划，你需要手动搭建一个包含地面、障碍物和 AGV 模型的简单场景。

操作步骤：

1. 在内容浏览器中搜索 “Ground Plane”，拖入视口作为地面。
2. 搜索 “Cube”，拖入视口，设置位置为 [2, 0, 0.5]，作为障碍物。
3. 搜索 “Jetbot” 或 “Cart” 等 AGV 模型（如果内容库中没有，可以从 Nucleus 下载），拖入视口，设置位置为 [0, 0, 0.2]。
4. 点击播放按钮，观察 AGV 是否稳定停在地面上，障碍物是否固定。
5. 保存场景为 test_agv.usd。

复盘：这个练习帮助你熟悉了场景搭建的基本流程。后续课程中，你将通过 Python 脚本自动完成这些操作，并添加传感器和路径规划算法。

2.6 常见误区与总结复盘

环境搭建阶段最容易出现的问题集中在路径、版本和依赖三个方面。以下总结常见误区及对应的解决方案。

总结复盘：环境搭建检查清单

• ✅ GPU 驱动 ≥ 535，nvidia-smi 正常输出
• ✅ Omniverse Launcher 安装成功，Isaac Sim 已安装
• ✅ Python 3.10 虚拟环境创建并激活
• ✅ isaacsim 包安装成功，import isaacsim 无报错
• ✅ GUI 启动正常，示例场景可加载
• ✅ Python 脚本能控制物体运动
• ✅ 熟悉视口导航、物体添加、属性修改、仿真播放等基础操作