- 类别
- 仿真与评测 · 仿真器
- 开放程度
- 开源
- 发布时间
- 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。版本更新后命令可能变化,以官方文档为准。
安装 PyBullet
官方推荐用 pip,cmake、premake 等构建方式不提供支持
pip3 install pybullet --upgrade --user运行示例
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 #3261fatal error: wchar.h: No such file or directory原因macOS 上 Anaconda 的 Python 编译环境有问题
解决提问者换成 python.org 下载的 Python 后解决;官方文档也建议试下面的命令
来源:Issue #1921CFLAGS='-stdlib=libc++' pip install pybulletFailed to create GL 3.0 context原因虚拟环境、远程桌面或显卡驱动只支持旧版 OpenGL
解决优先修好显卡驱动;否则连接时加 --opengl2 回退,这个模式功能不全
来源:Issue #1681p.connect(p.GUI, options="--opengl2")pybullet.error: Cannot load URDF file.原因只 pip 安装时,示例用到的 URDF 不在搜索路径上
解决用 pybullet_data 提供的数据路径,设置附加搜索路径
来源:Issue #1275p.setAdditionalSearchPath(pybullet_data.getDataPath())GLIBCXX原因Linux 上用 Anaconda 的 Python 时找不到 GLIBCXX
解决在 conda 环境里安装 libgcc
来源:docs.google.comconda install libgcc