1. 环境准备与系统配置

在树莓派上搭建PyQt5开发环境前，需要先做好基础准备。我推荐使用Raspberry Pi OS（原Raspbian）系统，这是官方为树莓派优化的Linux发行版，对硬件支持最完善。建议使用最新版本的Raspberry Pi OS with desktop，这样可以直接获得图形界面支持。

打开终端后首先更新系统包列表，这个步骤能确保我们安装的是最新版本的软件包：

sudo apt-get update

接着升级已安装的包到最新版本：

sudo apt-get upgrade

这个过程可能需要一些时间，取决于网络速度和系统当前状态。我实测下来，在树莓派4B上进行完整升级大约需要30分钟到1小时。如果中途遇到提示是否继续，输入Y并按回车即可。

安装编译PyQt5所需的依赖库是关键一步，缺少这些库会导致后续安装失败：

sudo apt-get install python3-pip libxcb1-dev libxi-dev libxrender-dev libfontconfig1-dev libpq-dev build-essential

这些依赖包中，libxcb1-dev和libxi-dev是X Window系统的开发库，PyQt5作为图形界面库需要它们。libfontconfig1-dev提供字体配置支持，build-essential包含GCC编译器等基本开发工具。我在多次安装中发现，如果漏掉libxrender-dev，在运行PyQt5程序时可能会出现渲染错误。

2. Python3.6安装与配置

虽然最新版Raspberry Pi OS已经预装了Python 3.7或更高版本，但有些项目可能需要特定的Python 3.6环境。如果需要安装Python 3.6，可以按照以下步骤操作。

首先安装Python 3.6的编译依赖：

sudo apt-get install libsqlite3-dev sqlite3 bzip2 libbz2-dev libssl-dev openssl libgdbm-dev liblzma-dev libreadline-dev libncursesw5-dev

下载Python 3.6源码并编译安装：

cd /usr/src
sudo wget https://www.python.org/ftp/python/3.6.15/Python-3.6.15.tgz
sudo tar xzf Python-3.6.15.tgz
cd Python-3.6.15
./configure --enable-optimizations
make -j4
sudo make altinstall

使用make -j4可以加速编译过程，这个数字根据树莓派型号调整：树莓派3B/3B+使用-j4，树莓派4B可以使用-j6。编译过程需要较长时间，在树莓派4B上大约需要1小时左右。

安装完成后，验证Python 3.6是否正确安装：

python3.6 --version

应该显示"Python 3.6.15"或类似版本号。接下来安装pip包管理工具：

wget https://bootstrap.pypa.io/pip/3.6/get-pip.py
sudo python3.6 get-pip.py

我建议将pip升级到最新版本，这样可以避免一些兼容性问题：

python3.6 -m pip install --upgrade pip

3. PyQt5安装方法详解

PyQt5的安装有多种方法，每种方法各有优缺点。最简单的方法是通过pip直接安装二进制包：

pip3 install PyQt5

或者如果使用Python 3.6：

python3.6 -m pip install PyQt5

这种方法最方便，但有时可能无法找到适合树莓派架构的预编译包。如果遇到这种情况，会自动从源码编译，这需要较长时间。

第二种方法是通过系统包管理器安装：

sudo apt-get install python3-pyqt5

这种方法的优点是安装速度快，依赖关系自动处理。但缺点是版本可能不是最新的，而且与特定Python版本绑定。

如果以上方法都失败，就需要从源码编译安装。这是最复杂但也是最可靠的方法：

# 安装Qt5开发工具
sudo apt-get install qt5-default qttools5-dev-tools

# 下载并编译SIP（PyQt5的依赖）
wget https://www.riverbankcomputing.com/static/Downloads/sip/sip-4.19.25.tar.gz
tar xzf sip-4.19.25.tar.gz
cd sip-4.19.25
python3.6 configure.py
make
sudo make install

# 下载并编译PyQt5
wget https://www.riverbankcomputing.com/static/Downloads/PyQt5/PyQt5-5.15.6.tar.gz
tar xzf PyQt5-5.15.6.tar.gz
cd PyQt5-5.15.6
python3.6 configure.py
make -j4
sudo make install

从源码编译需要很长时间，在树莓派4B上大约需要2-3小时。期间可能会遇到内存不足的问题，可以通过增加交换空间来解决：

sudo dphys-swapfile swapoff
sudo nano /etc/dphys-swapfile
# 将CONF_SWAPSIZE=100改为CONF_SWAPSIZE=1024
sudo dphys-swapfile setup
sudo dphys-swapfile swapon

4. 安装验证与问题排查

安装完成后需要验证PyQt5是否正确安装。创建一个简单的测试脚本：

import sys
from PyQt5 import QtWidgets

app = QtWidgets.QApplication(sys.argv)
window = QtWidgets.QWidget()
window.setWindowTitle('PyQt5安装测试')
window.resize(300, 200)
window.show()
sys.exit(app.exec_())

保存为test_pyqt5.py并运行：

python3 test_pyqt5.py

如果看到一个小窗口弹出，说明PyQt5安装成功。如果遇到问题，常见的错误和解决方法包括：

ImportError: No module named 'PyQt5'：这表示PyQt5没有安装到当前Python环境中。检查Python版本和安装路径是否正确。

Could not find or load the Qt platform plugin "xcb"：这是缺少显示相关的库，安装以下包解决：

sudo apt-get install libxkbcommon-x11-0 libxcb-icccm4 libxcb-image0 libxcb-keysyms1 libxcb-randr0 libxcb-render-util0 libxcb-xinerama0

段错误（Segmentation fault）：这通常是版本不兼容导致的，建议使用虚拟环境重新安装。

我建议使用虚拟环境来管理Python项目，这样可以避免系统范围内的包冲突：

python3 -m venv myproject_env
source myproject_env/bin/activate
pip install PyQt5

虚拟环境激活后，命令行提示符前会显示环境名称，所有pip安装的包都会安装到这个隔离环境中。

5. 物联网控制面板实战开发

现在我们来开发一个实用的物联网控制面板，这个案例综合运用了PyQt5的各种功能。首先设计主界面，包含状态显示区和控制按钮。

创建主窗口类：

from PyQt5 import QtWidgets, QtCore, QtGui
import sys

class IoTControlPanel(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        self.setWindowTitle('物联网控制面板')
        self.resize(800, 600)
        self.setup_ui()
        
    def setup_ui(self):
        # 创建中央部件和主布局
        central_widget = QtWidgets.QWidget()
        self.setCentralWidget(central_widget)
        main_layout = QtWidgets.QHBoxLayout(central_widget)
        
        # 左侧状态面板
        status_frame = QtWidgets.QFrame()
        status_frame.setFrameStyle(QtWidgets.QFrame.Box)
        status_layout = QtWidgets.QVBoxLayout(status_frame)
        
        # 设备状态显示
        self.device_status = QtWidgets.QLabel('设备状态: 离线')
        self.temperature_label = QtWidgets.QLabel('温度: --°C')
        self.humidity_label = QtWidgets.QLabel('湿度: --%')
        
        status_layout.addWidget(self.device_status)
        status_layout.addWidget(self.temperature_label)
        status_layout.addWidget(self.humidity_label)
        
        # 右侧控制面板
        control_frame = QtWidgets.QFrame()
        control_frame.setFrameStyle(QtWidgets.QFrame.Box)
        control_layout = QtWidgets.QVBoxLayout(control_frame)
        
        # 控制按钮
        self.led_button = QtWidgets.QPushButton('LED: 关闭')
        self.fan_button = QtWidgets.QPushButton('风扇: 关闭')
        self.pump_button = QtWidgets.QPushButton('水泵: 关闭')
        
        # 连接按钮信号
        self.led_button.clicked.connect(self.toggle_led)
        self.fan_button.clicked.connect(self.toggle_fan)
        self.pump_button.clicked.connect(self.toggle_pump)
        
        control_layout.addWidget(self.led_button)
        control_layout.addWidget(self.fan_button)
        control_layout.addWidget(self.pump_button)
        
        # 添加到主布局
        main_layout.addWidget(status_frame, 1)
        main_layout.addWidget(control_frame, 1)
        
        # 定时更新数据
        self.timer = QtCore.QTimer()
        self.timer.timeout.connect(self.update_sensor_data)
        self.timer.start(5000)  # 5秒更新一次
        
    def toggle_led(self):
        current_text = self.led_button.text()
        new_state = '开启' if '关闭' in current_text else '关闭'
        self.led_button.setText(f'LED: {new_state}')
        # 这里添加实际控制GPIO的代码
        
    def toggle_fan(self):
        current_text = self.fan_button.text()
        new_state = '开启' if '关闭' in current_text else '关闭'
        self.fan_button.setText(f'风扇: {new_state}')
        
    def toggle_pump(self):
        current_text = self.pump_button.text()
        new_state = '开启' if '关闭' in current_text else '关闭'
        self.pump_button.setText(f'水泵: {new_state}')
        
    def update_sensor_data(self):
        # 模拟传感器数据更新
        import random
        temperature = random.randint(20, 30)
        humidity = random.randint(40, 80)
        
        self.temperature_label.setText(f'温度: {temperature}°C')
        self.humidity_label.setText(f'湿度: {humidity}%')

if __name__ == '__main__':
    app = QtWidgets.QApplication(sys.argv)
    window = IoTControlPanel()
    window.show()
    sys.exit(app.exec_())

这个基础框架包含了状态显示和控制功能，接下来我们添加实时数据图表显示：

# 在setup_ui方法中添加图表
def setup_ui(self):
    # ... 之前的代码 ...
    
    # 添加图表显示
    self.plot_widget = QtWidgets.QWidget()
    plot_layout = QtWidgets.QVBoxLayout(self.plot_widget)
    
    # 使用Matplotlib集成图表
    try:
        from matplotlib.backends.backend_qt5agg import FigureCanvasQTAgg as FigureCanvas
        from matplotlib.figure import Figure
        import matplotlib.pyplot as plt
        
        self.figure = Figure(figsize=(5, 3))
        self.canvas = FigureCanvas(self.figure)
        self.ax = self.figure.add_subplot(111)
        self.ax.set_title('温度变化曲线')
        self.temperature_data = []
        
        plot_layout.addWidget(self.canvas)
        status_layout.addWidget(self.plot_widget)
        
    except ImportError:
        print("Matplotlib未安装，图表功能不可用")

为了连接真实的物联网设备，我们需要添加GPIO控制功能。首先安装RPi.GPIO库：

pip3 install RPi.GPIO

然后在代码中添加GPIO控制：

import RPi.GPIO as GPIO
import time

class IoTControlPanel(QtWidgets.QMainWindow):
    def __init__(self):
        super().__init__()
        # 初始化GPIO
        GPIO.setmode(GPIO.BCM)
        self.led_pin = 17
        self.fan_pin = 27
        self.pump_pin = 22
        
        GPIO.setup(self.led_pin, GPIO.OUT)
        GPIO.setup(self.fan_pin, GPIO.OUT)
        GPIO.setup(self.pump_pin, GPIO.OUT)
        
    def toggle_led(self):
        current_state = GPIO.input(self.led_pin)
        new_state = not current_state
        GPIO.output(self.led_pin, new_state)
        
        status = '开启' if new_state else '关闭'
        self.led_button.setText(f'LED: {status}')

6. 性能优化与部署技巧

在树莓派上运行PyQt5应用时，性能优化很重要。以下是我在实际项目中总结的优化技巧：

界面优化：避免使用过于复杂的视觉效果，减少透明度和阴影效果。使用QSS（Qt样式表）而不是图片资源来定义界面样式：

self.setStyleSheet("""
    QMainWindow {
        background-color: #f0f0f0;
    }
    QPushButton {
        background-color: #4CAF50;
        border: none;
        color: white;
        padding: 10px;
        border-radius: 5px;
    }
    QPushButton:hover {
        background-color: #45a049;
    }
    QFrame {
        background-color: white;
        border-radius: 8px;
    }
""")

内存管理：树莓派内存有限，需要注意内存使用。及时删除不再需要的对象，使用Qt的内存管理机制：

# 使用QObject.deleteLater()安全删除对象
def cleanup(self):
    self.timer.stop()
    self.timer.deleteLater()
    GPIO.cleanup()

部署打包：使用PyInstaller将应用打包为独立可执行文件：

pip3 install pyinstaller
pyinstaller --onefile --windowed your_app.py

对于树莓派，可能需要添加特定参数：

pyinstaller --onefile --add-binary '/usr/lib/arm-linux-gnueabihf/libQt5Core.so.5:.' your_app.py

远程调试：在开发过程中，可以使用SSH+X11转发在本地电脑上调试树莓派应用：

ssh -X pi@树莓派IP地址
python3 your_app.py

这样应用界面会显示在本地电脑上，但实际运行在树莓派上。

日志记录：添加详细的日志记录，方便排查问题：

import logging
logging.basicConfig(
    level=logging.DEBUG,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s',
    handlers=[
        logging.FileHandler('iot_control.log'),
        logging.StreamHandler()
    ]
)

在实际部署时，可以将应用设置为开机自启动。创建桌面文件：

nano ~/.config/autostart/iot_control.desktop

添加以下内容：

[Desktop Entry]
Type=Application
Name=IoT控制面板
Exec=python3 /home/pi/iot_control.py

对于长时间运行的应用，建议使用systemd服务来管理：

sudo nano /etc/systemd/system/iot_control.service

添加服务配置：

[Unit]
Description=IoT Control Panel Service
After=graphical.target

[Service]
Environment=DISPLAY=:0
User=pi
WorkingDirectory=/home/pi
ExecStart=/usr/bin/python3 /home/pi/iot_control.py
Restart=always

[Install]
WantedBy=graphical.target

然后启用服务：

sudo systemctl enable iot_control.service
sudo systemctl start iot_control.service

这些优化技巧和部署方法都是我在实际项目中验证过的，能够显著提升应用性能和稳定性。特别是在资源有限的树莓派上，合理的优化可以让应用运行更加流畅。