四个官方仓库先分清,再决定从哪个入手
宇树官方在代码托管平台上并列放着四个与 Go2 生态相关的仓库,它们的定位、许可、默认分支和面向的机型并不一样。项目登记里挂的仓库是 unitree_sdk2,这只是一个指向,不代表官方只有这一个仓库;四个仓库是并列关系,本页按抓取日期 2026-11-18 的官方仓库元数据把它们放在一起对照。
表里 star、fork、open issues 与 created、pushed 都来自官方仓库元数据接口,标注抓取日期 2026-11-18,是当天的快照值,不写成实时值;官方仓库的推送时间与第三方 star 快照不同源,不互相替换混用。表后的定位表再回答「各自管什么、该从哪个入手」。
| 仓库 | stars | forks | open issues | 许可 | 语言 | 默认分支 | 创建日期 | 推送日期 |
|---|---|---|---|---|---|---|---|---|
| unitree_sdk2 | 1452 | 404 | 15 | BSD-3-Clause | C++ | main | 2023-09-22 | 2026-11-18 |
| unitree_sdk2_python | 849 | 356 | 142 | BSD-3-Clause | Python | master | 2024-04-26 | 2026-09-21 |
| unitree_ros2 | 898 | 265 | 14 | BSD-3-Clause | C++ | master | 2023-10-20 | 2026-07-02 |
| unitree_lerobot | 791 | 142 | 33 | NOASSERTION·Other | Python | main | 2024-10-18 | 2026-05-25 |
各自定位与该从哪个仓库入手
| 仓库 | 官方描述要点 | 与 Go2 的关系 | 该不该从这里入手 |
|---|---|---|---|
| unitree_sdk2 | 自述为 Unitree robot sdk version 2,仓库描述直接指向宇树文档中心;自述分 Prebuild environment、Environment Setup、Build examples、Installation、Notice 几段,Notice 指向文档中心 | Go2 主力 SDK,C++ 接口 | 准备用 C++ 按官方 SDK 做开发时从这里入手;项目 repository_url 挂的也是它 |
| unitree_sdk2_python | 自述为 Python interface for unitree sdk2;依赖 Python 3.8 及以上、cyclonedds 0.10.2、numpy、opencv-python;例程含 DDS 通信、高层状态与控制、底层状态与控制、无线遥控器状态、前相机、避障开关、音量灯光,数据结构与控制方式与 unitree_sdk2 保持一致 | Go2 的 Python 接口 | 用 Python 写例程、不写 C++ 时从这里入手 |
| unitree_ros2 | 自述基于 Cyclonedds,写明支持 Unitree Go2、B2 与 H1;测试系统为 Ubuntu 20.04 配 foxy、Ubuntu 22.04 配 humble;含 cyclonedds_ws 与 example 工作区,以及 read_motion_state、read_low_state、go2_sport_client 等例程,用 ROS2 msg 直接通信与控制 | Go2 的 ROS2 接口 | 已有 ROS2 工程、按 topic 收发时从这里入手 |
| unitree_lerobot | LeRobot 开源训练框架的改造;发布记录 v0.1 起支持 G1 + Dex1 + Dex3,v0.2 增加 brainco 与 inspire1 灵巧手;示例数据集为 G1_Dex3_ToastedBread_Dataset,真机推理脚本为 eval_g1,环境里另装 unitree_sdk2_python 只作 DDS 通信铺垫 | 不是 Go2 的直接二开证据,面向 G1 双臂与灵巧手数采生态 | 不把这里当作给 Go2 写二开程序的入口;它属于另一条机型线上的生态辅助仓库 |
单独写死:unitree_lerobot 不是 Go2 的二开证据
这一条在中文资料里最容易串台,单独列清楚:unitree_lerobot 面向 G1 双臂与灵巧手数采,不是 Go2 的直接二开证据。仓库自述是对 Hugging Face LeRobot 训练框架的改造,用来训练和测试由宇树 G1 双臂、灵巧手采集的数据;发布记录从 v0.1 起就写 G1 + Dex1 + Dex3,示例数据集、真机推理脚本与数据集转换里的 robot_type 举例都以 Unitree_G1 系列为主,没有 Go2 的条目。四个仓库并列看时,前三个才是 Go2 的开发接口,unitree_lerobot 是另一条机型线上的生态辅助仓库。
本 wiki 不把 unitree_lerobot 写成 Go2 可以照着二开的材料,也不据它推断任何 Go2 的二开能力或限制;Go2 能二开到哪一层,结论仍回到官方文档中心的电气接口口径与《Go2 SDK 开发指南》的适用型号声明。
默认分支差异:自己 clone 时最容易踩的坑
四个仓库的默认分支并不统一,这一点在按 README 链接取文件、或自己拼仓库里某个文件的链接时最容易出错。官方仓库元数据的抓取留痕里记着:首次按 main 分支去抓 README,有两个仓库直接返回 404,改成 master 之后才拿到 200,这两个正是默认分支为 master 的 unitree_sdk2_python 与 unitree_ros2。
| 仓库 | 默认分支 |
|---|---|
| unitree_sdk2 | main |
| unitree_sdk2_python | master |
| unitree_ros2 | master |
| unitree_lerobot | main |
玩家自己 clone 时若照着 main 去拼文件链接或切分支,会在默认分支是 master 的仓库上取不到内容;动手取文件前先看仓库页标的是 main 还是 master,比记住某一串固定链接可靠。四个仓库的 README 当时都已落盘,落盘留痕还记着两个仓库首次取元数据遇到未认证限流、带 UA 重试后才拿到 200,这些只说明取证过程,不改变上表的快照值。这里只写清默认分支的差别与取不到文件的原因,不替官方补写任何分支迁移结论。
从 unitree_sdk2 入手时的环境落点与边界提醒
若按上表判断从 unitree_sdk2 开始,官方仓库 README 给出的构建环境要求可作为准备环境时的核对项。
| 环境项 | 官方要求 |
|---|---|
| 操作系统 | Ubuntu 20.04 LTS |
| CMake | 3.10 及以上 |
| GCC | 9.4.0 |
另外要留住一条边界:即便代码从 unitree_sdk2 入手,对应的官方《Go2 SDK 开发指南》仍只适用于 Go2 Edu 型号,并按软件版本分「低于 V1.1.6」与「V1.1.6 及以上」两套接口;这两个判断放在「按型号找到官方开发入口」那一页逐条核对,本页不把仓库环境要求当成「四个版本都能照着开发」的结论。
核完手里多了什么
- 按语言与开发方式选定一个主仓库:C++ 看 unitree_sdk2,Python 看 unitree_sdk2_python,ROS2 工程看 unitree_ros2。
- 把 unitree_lerobot 明确排除在 Go2 二开入口之外,记住它面向的是 G1 双臂与灵巧手数采。
- 动手取文件前先确认目标仓库默认分支是 main 还是 master,避免按 main 去 master 仓库取不到内容。
- 若从 unitree_sdk2 入手,按 Ubuntu 20.04、CMake 3.10 及以上、GCC 9.4.0 核对环境,并把型号与软件版本边界带回开发入口页确认。
核完的结果:手里有一张「四个仓库各管什么、我该进哪一个、clone 前先看哪个分支」的对照,不会把生态辅助仓库误当成 Go2 的开发入口,也不会以为官方只有项目登记里挂的那一个仓库。