树莓派4安装PySide6失败求助：如何运行QtCreator+PySide6+cv2项目

问题根源 #

树莓派采用ARM架构，PyPI官方仓库中没有针对该架构的PySide6预编译包，因此直接执行pip install pyside6会失败。以下是两种可行的解决方法：

方法一：通过系统apt仓库安装PySide6（推荐，无需编译） #

1. 更新系统包列表并升级现有软件：

   sudo apt update && sudo apt full-upgrade -y
   

2. 安装PySide6核心模块及常用组件：

   sudo apt install python3-pyside6 python3-pyside6.qtcore python3-pyside6.qtgui python3-pyside6.qtwidgets
   

3. 若项目依赖其他Qt模块（如QtMultimedia、QtNetwork），可通过以下命令搜索并安装对应包：

   apt search python3-pyside6
   

方法二：从源码编译安装PySide6（适用于需要特定版本的场景） #

1. 安装编译所需的依赖工具和Qt库：

   sudo apt install build-essential cmake git python3-dev python3-pip libqt6core6 libqt6gui6 libqt6widgets6 libqt6network6 qt6-base-dev qt6-tools-dev-tools
   

2. 升级pip及相关工具：

   python3 -m pip install --upgrade pip setuptools wheel
   

3. 安装Shiboken6（PySide6的绑定生成工具）：

   python3 -m pip install shiboken6
   

4. 克隆指定版本的PySide6源码（以6.5.3为例，可根据项目需求替换版本号）：

   git clone --branch 6.5.3 https://code.qt.io/pyside/pyside6.git
   

5. 编译并安装：

   cd pyside6
   mkdir build && cd build
   cmake .. -DPYTHON_EXECUTABLE=/usr/bin/python3 -DCMAKE_INSTALL_PREFIX=/usr/local
   make -j4  # 利用树莓派4的4核加速编译，耗时约1-2小时
   sudo make install
   

验证安装并运行项目 #

1. 确认PySide6安装成功：

   python3 -c "import PySide6; print(PySide6.__version__)"
   

2. 配置QtCreator的Python解释器：
   • 打开QtCreator，进入工具 > 选项 > Python > 解释器
   • 选择系统默认的python3路径（通常为/usr/bin/python3）
3. 确保OpenCV依赖正常：

   sudo apt install python3-opencv
   

4. 导入项目并运行，若出现模块缺失报错，按需补充对应依赖包即可。

内容的提问来源于stack exchange，提问作者Jorge Augusto Wilchen