版本选择决策树#

学习目标

读完本页你能：

回答几个问题后，确定自己该装哪套 Isaac Sim + Isaac Lab 组合
说出本站为什么以 5.1.0 + 2.3.2 为主线
在一台机器上让主线与前沿两套环境并存

前置知识

1.1 版本兼容矩阵：各版本的依赖数值都在那里

Isaac Sim 5.1.0 已不再获官方支持

Isaac Sim 5.1.0 的官方文档每页顶部标注 "Unsupported release: Isaac Sim 5.1.0 is no longer supported."[1] 本站仍以 Isaac Sim 5.1.0 + Isaac Lab 2.3.2 为主线，理由是 Isaac Lab 2.3.x 最高只支持 Isaac Sim 5.1[2]，而 Isaac Lab 3.0 仍为 Early Access，GA 目标为 2026 年 10 月底[3]。3.0 GA 后本站将切换主线，进展见 8.6 3.0 版本追踪。

决策树#

这一节回答：我该装哪一套？

从左往右回答问题，走到的叶子就是建议组合。每个判断的依据在下文和 1.1 中。

        %%{init: {"flowchart": {"rankSpacing": 30, "nodeSpacing": 16, "padding": 6}}}%%
flowchart LR
    Q1{"目标？"}
    Q2{"需要 3.0 的<br/>新特性吗？"}
    Q3{"能接受 EA<br/>版本的变动吗？"}
    Q4{"手上已有<br/>2.x 代码吗？"}
    Q5{"驱动能到<br/>580.65.06 以上吗？"}
    A["主线<br/>Isaac Sim 5.1.0<br/>+ Isaac Lab 2.3.2"]
    B["前沿<br/>Isaac Sim 6.1<br/>+ Isaac Lab 3.0.0-EA"]
    AB["主线为主<br/>前沿另建环境试用"]
    C["旧组合<br/>Isaac Sim 4.5<br/>+ 论文所用的 2.x"]
    UP["先升级驱动"]

    Q1 -- "复现基于 4.5 的旧论文" --> C
    Q1 -- "学习 / 新项目" --> Q2
    Q2 -- "否" --> Q5
    Q2 -- "是" --> Q3
    Q3 -- "否，等 GA" --> Q5
    Q3 -- "是" --> Q4
    Q4 -- "是" --> AB
    Q4 -- "否" --> B
    Q5 -- "能" --> A
    Q5 -- "不能" --> UP
    UP --> A

    classDef main stroke:#76b900,stroke-width:3px
    class A,AB main

图 1：版本选择决策树，左→右阅读。菱形是问题，方框是建议组合，绿色粗框是本站推荐的结果。前沿组合同样要求驱动 ≥ 580.65.06，图中为简洁未重复画出。

每个结果的理由#

这一节回答：为什么是这个建议？

主线：Isaac Sim 5.1.0 + Isaac Lab 2.3.2。 这是 Isaac Lab 2.3.2 官方推荐的组合[4]，也是 2.x 系列的最后一个版本[5]。它稳定，教程、社区讨论和第三方代码最多。本站所有示例都在这个组合上验证。代价是用不到 3.0 的新后端。

前沿：Isaac Sim 6.1 + Isaac Lab 3.0.0-EA。 3.0 带来多物理后端、Kit-less 运行和 Warp 原生数据路径[6]。但它目前是 Early Access：官方表示 EA 到 GA 期间只修缺陷，GA 目标在 2026 年 10 月底[6]；同时它有大量破坏性变更，如四元数顺序从 WXYZ 改为 XYZW、.data.* 不再直接返回 torch.Tensor[6]。这意味着 2.x 的代码和教程不能直接照搬，EA 期间的细节也可能再变。本站把 3.0 的内容集中在第 8 部分，并标注"EA，可能变动"。

主线为主、前沿另建环境试用。 已经有 2.x 代码又想试 3.0 的人，最稳妥的做法是不动原环境，另建一套 3.0 环境做迁移实验。3.0 官方也要求从全新的 Python 3.12 环境开始，不要在 2.x 环境上原地升级[6]。

旧组合：Isaac Sim 4.5 + 论文所用的 Isaac Lab 2.x。 只在复现明确基于 Isaac Sim 4.5 的旧论文代码时使用，Isaac Lab 版本照论文代码所用的来。2.0.x、2.1.x 只支持 Isaac Sim 4.5，2.2.x、2.3.x 也仍支持 4.5[7]；Isaac Sim 4.5 需要 Python 3.10[8]。不建议用它开新项目：Isaac Sim 4.5 的官方文档站已经下线（见 1.1 的说明）。

先升级驱动。 2.3.2 与 3.0 的安装页都推荐 Linux 驱动 580.65.06 或更新[4][9]，3.0 使用的 CUDA 13.0 PyTorch 更是以它为下限[9]。能升级就先升级；实在不能升级（例如共享集群），请先与管理员确认，本站不对低于推荐版本的驱动做验证。

两套并存#

这一节回答：一台机器能同时装主线和前沿吗？

可以，关键是两套独立的 Python 环境。主线的 Isaac Sim 5.1 要求 Python 3.11，前沿的 Isaac Sim 6.1 与 Isaac Lab 3.0 要求 Python 3.12[8][9]，两者本来就不能装在同一个环境里。

建议的做法：

用 conda 或 venv 各建一个环境，名字里带上版本，例如 env_isaaclab_23 和 env_isaaclab_30。
两套 Isaac Lab 源码放在不同目录，各自对应自己的环境。
资产缓存与训练输出目录分开，避免 USD 资产和 checkpoint 混用。

具体安装步骤见 1.4 安装 Isaac Sim 5.1 + Isaac Lab 2.3.2（pip 方式）与 1.5 安装 Isaac Sim 6.1 + Isaac Lab 3.0-EA。

常见误解#

误解一：新版本一定更好

对学习和新项目来说，稳定比新更重要。3.0.0-EA 仍在 EA 阶段，并且有大量破坏性变更[6]；用它学习，会同时碰到框架本身的变动和网上 2.x 资料对不上的问题。

误解二：Isaac Lab 3.0 可以配 Isaac Sim 5.1

不行。3.0 的完整 Isaac Sim 工作流只支持 6.1，官方明确写明不支持 5.1 及更早版本[9]。

误解三：装了 Isaac Sim 6.1 就能跑 Isaac Lab 2.3.2 的例子

也不行。2.3.x 声明支持的是 Isaac Sim 4.5、5.0、5.1[7]，而且 6.1 要求 Python 3.12，2.3.2 的环境是 3.11[8]。

误解四：驱动越新越好，随便装最新的

官方建议使用**生产分支（production branch）**的最新驱动[4]，不是任意最新的测试版驱动。

切换时机#

这一节回答：本站什么时候把主线换成 3.0？

3.0 发布 GA 之后，本站会评估是否把主线切换到 Isaac Sim 6.1 + Isaac Lab 3.0。切换前，主线页面保持 5.1.0 + 2.3.2 不变。进展与变更记录见 8.6 3.0 版本追踪。

延伸阅读#

版本说明#

本页的建议针对 2026-09-30 的版本状况：主线 2.3.2 为 2.x 的最终版本，3.0 为 EA。3.0 GA 后本页会随切换决定更新。