已安装PyBullet仍触发ModuleNotFoundError的解决方法

原因分析 #

以root用户执行pip install时，包会被安装到root专属的Python环境目录中，而你后续运行代码使用的是普通用户的Python解释器，自然无法找到该包。另外也可能是你调用的pip和python/python3不属于同一个环境，导致安装路径与解释器搜索路径不匹配。

解决方案 #

1. 匹配pip与Python解释器的对应关系 #

先确认当前使用的Python解释器路径：

which python
# 若用Python3则执行
which python3

再确认pip的路径：

which pip
# 对应Python3则执行
which pip3

如果两者路径不匹配（比如python是普通用户路径，pip是root路径），直接用对应解释器的内置pip来安装：

# 示例：若python路径为/home/user/bin/python3
/home/user/bin/python3 -m pip install pybullet

这样包会直接安装到当前用户的Python环境中。

2. 使用虚拟环境安装（推荐，彻底解决root权限问题） #

虚拟环境可隔离项目依赖，还能规避root权限带来的各种问题：

• 创建虚拟环境：

# Python3.3+自带venv模块，直接执行
python3 -m venv pybullet_env

• 激活虚拟环境：

# Linux/macOS系统
source pybullet_env/bin/activate
# Windows cmd命令行
pybullet_env\Scripts\activate.bat
# Windows PowerShell
pybullet_env\Scripts\Activate.ps1

• 激活后直接安装PyBullet，无需root权限：

pip install pybullet

• 后续运行代码前先激活虚拟环境，即可正常导入PyBullet。

3. 临时添加root安装的包路径到Python搜索路径（不推荐） #

如果不想重新安装，可临时将root下的PyBullet路径加入Python搜索范围：
先查找PyBullet的安装路径：

sudo pip show pybullet | grep Location

得到路径后，在代码开头添加：

import sys
sys.path.append("上述命令得到的路径")
import pybullet as p

此方法易引发依赖冲突，仅作为临时应急方案。

内容的提问来源于stack exchange，提问作者Md Tawsif Mostafiz 170021031