打开rqt时出现No Module Named PyQt5与PySide2错误求助

问题根源 #

手动从Qt官网安装的Qt仅包含C++框架，并没有附带Python绑定库（PyQt5或PySide2），而rqt作为ROS的GUI工具，必须依赖这些Python绑定才能运行。你的Python和ROS基础功能正常，说明核心环境没问题，只是缺少GUI依赖的绑定包。

修复步骤 #

1. 确认ROS关联的Python环境 #

先确定ROS正在使用的Python路径，避免装错环境：

• Linux/macOS：

which python3

• Windows：

where python3

确认输出路径指向你安装的Python 3.8.3。

2. 安装匹配版本的PyQt5 #

直接用pip给ROS关联的Python安装与Qt 5.12.12兼容的PyQt5版本：

pip3 install PyQt5==5.12.3

如果你的pip不在系统PATH里，直接指定Python的pip路径执行：

C:\[你的Python3.8.3路径]\Scripts\pip.exe install PyQt5==5.12.3

3. 验证绑定安装成功 #

打开Python终端执行：

import PyQt5
print(PyQt5.__version__)

输出5.12.3则说明安装有效。

4. 重启rqt #

直接运行命令：

rqt

此时应该能正常启动rqt界面。

备选方案：安装PySide2 #

如果PyQt5安装遇到问题，可尝试安装ROS支持的另一种Qt Python绑定：

pip3 install PySide2==5.12.0

同样确保版本与Qt 5.12.12匹配。

内容的提问来源于stack exchange，提问作者etemeskutCEO