如何将Qt的qmake工具配置到系统PATH中？——Raspbian（基于Debian）系统下PyQtWebEngine安装报错解决方案咨询

Hey there, let's work through this PyQtWebEngine installation issue on your Raspbian system step by step. I've dealt with similar PATH-related headaches with Qt tools before, so here's what you need to do:

1. 先确认qmake的安装位置 #

首先得搞清楚你的qmake到底装在哪：

• 在终端运行 which qmake，如果返回类似 /usr/lib/qt5/bin/qmake 或者 /usr/bin/qmake 的路径，那我们只需要把这个父目录加到PATH里就行。
• 如果 which qmake 没有输出，说明你可能装错了Qt版本包。PyQtWebEngine是基于Qt5的，所以安装对应版本的qmake：

  sudo apt-get update
  sudo apt-get install qt5-qmake
  

2. 将qmake所在目录添加到系统PATH #

分临时生效和永久生效两种方式：

临时生效（仅当前终端会话） #

如果qmake在 /usr/lib/qt5/bin 目录下，运行下面的命令就能立刻把它加到PATH：

export PATH="$PATH:/usr/lib/qt5/bin"

马上测试一下：运行 qmake --version，如果能显示Qt5的版本信息，说明已经生效了。

永久生效（重启后依然有效） #

要让这个修改一直生效，需要编辑你的bash配置文件：

1. 用nano打开配置文件：

   nano ~/.bashrc
   

2. 滚动到文件末尾，添加一行（把路径换成你找到的qmake所在目录）：

   export PATH="$PATH:/usr/lib/qt5/bin"
   

3. 保存并退出nano（按Ctrl+O，回车，再按Ctrl+X）。
4. 不用重启，直接让配置生效：

   source ~/.bashrc
   

验证一下：运行 echo $PATH 应该能看到qmake的目录，qmake --version 也能正常输出信息。

3. 不用管那个config.py文件 #

你之前看到的config.py相关解决方案大概率是过时的，或者只适用于非常特殊的自定义场景。只要qmake在PATH里，pip会自动检测到它，完全不需要新建或修改任何config文件。

4. 关于之前的PyQt4错误提示 #

那个"Make sure you have a working Qt qmake on your PATH"的PyQt4错误，本质也是Qt工具不在PATH里的问题。但你现在要装的PyQtWebEngine属于PyQt5生态，所以专注用Qt5的qmake就好——PyQt4已经被废弃了，那个旧错误可以直接忽略。

5. 正确安装PyQtWebEngine #

现在PATH配置好了，有两种安装方式可选：

方式1：用Raspbian预编译包（推荐） #

像Raspbian这种Debian系系统，预编译的PyQtWebEngine包比pip源码编译更稳定，直接用apt安装：

sudo apt-get install python3-pyqt5.qtwebengine

方式2：用pip安装 #

如果需要特定版本或其他需求，用pip安装（Raspbian默认是Python3，所以用pip3）：

pip3 install pyqtwebengine

现在qmake已经在PATH里了，编译安装应该能顺利完成。

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