仿真器开源

PyBullet

erwincoumans

GitHub 仓库 bulletphysics/bullet3

又称 Bullet Physics SDK、Bullet、bullet3

类别
仿真与评测 · 仿真器
开放程度
开源
发布时间
2016 年 4 月
开源协议
Zlib

项目简介

Bullet Physics SDK 是开源的实时碰撞检测与多物理仿真库,PyBullet 是它的 Python 绑定,推荐用于机器人、强化学习和 VR。可做刚体与多体动力学仿真,自带强化学习示例环境和 DeepMimic 人形动作模仿示例;C++ 库支持 Windows、Linux、macOS、iOS、Android,另有实验性的 OpenCL GPU 版本。

PyBullet 安装要点

来源:README.md

依据官方资料的 3.25 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。

  1. 安装 PyBullet

    官方推荐用 pip,cmake、premake 等构建方式不提供支持

    pip3 install pybullet --upgrade --user
  2. 运行示例

    python3 -m pybullet_envs.examples.enjoy_TF_AntBulletEnv_v0_2017may

环境要求

来源:docs.google.com
系统来源:docs.google.com
Windows、macOS、Linux
Python来源:docs.google.com
官方只写多数 2.x、3.x 版本应可用,没有给明确范围
OpenGL来源:docs.google.com
默认用 OpenGL 3,不支持时可用 --opengl2 回退

常见报错

解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。

error: Microsoft Visual C++ 14.0 or greater is required.

原因Windows 上 pip 要编译,缺 C++ 编译环境

解决完整安装带 C++ 支持的 Visual Studio 2019

来源:Issue #3261
fatal error: wchar.h: No such file or directory

原因macOS 上 Anaconda 的 Python 编译环境有问题

解决提问者换成 python.org 下载的 Python 后解决;官方文档也建议试下面的命令

CFLAGS='-stdlib=libc++' pip install pybullet
来源:Issue #1921
Failed to create GL 3.0 context

原因虚拟环境、远程桌面或显卡驱动只支持旧版 OpenGL

解决优先修好显卡驱动;否则连接时加 --opengl2 回退,这个模式功能不全

p.connect(p.GUI, options="--opengl2")
来源:Issue #1681
pybullet.error: Cannot load URDF file.

原因只 pip 安装时,示例用到的 URDF 不在搜索路径上

解决用 pybullet_data 提供的数据路径,设置附加搜索路径

p.setAdditionalSearchPath(pybullet_data.getDataPath())
来源:Issue #1275
GLIBCXX

原因Linux 上用 Anaconda 的 Python 时找不到 GLIBCXX

解决在 conda 环境里安装 libgcc

conda install libgcc
来源:docs.google.com

获取方式

数据来源

本页信息均整理自以下公开资料。

7 条来源核验于 2026-10-01

星标、下载量等指标定期自动更新。

PyBullet(bullet3):安装步骤、环境要求与常见报错 | 具身集