如何在树莓派Zero W闪屏后、桌面加载前运行PySide2 GUI？

核心思路 #

使用systemd服务控制程序启动时机，结合xinit直接启动X服务器运行GUI，跳过桌面环境加载，同时确保在闪屏结束后启动程序。

步骤1：设置系统启动到命令行模式 #

确保系统默认不加载桌面环境，自动以pi用户登录到命令行：

• 运行配置工具：

  sudo raspi-config
  

• 依次选择：System Options → Boot / Auto Login → Console Autologin，保存退出。

或者用命令行直接设置：

sudo systemctl set-default multi-user.target

步骤2：创建systemd服务文件 #

创建自定义服务文件控制GUI启动逻辑：

1. 新建服务文件：

   sudo nano /etc/systemd/system/gui-start.service
   

2. 粘贴以下内容（路径按需调整）：

   [Unit]
   Description=Auto-start PySide2 GUI
   After=plymouth-quit.service  # 绑定闪屏结束事件
   Wants=systemd-user-sessions.service
   
   [Service]
   User=pi
   # 设置X环境变量，确保PySide2能调用显示
   Environment=DISPLAY=:0
   Environment=XAUTHORITY=/home/pi/.Xauthority
   # 用xinit启动X服务器并运行GUI程序
   ExecStart=/usr/bin/xinit /usr/bin/python3 /home/pi/GUI.py -- :0
   # 可选：程序崩溃后自动重启
   Restart=always
   RestartSec=5
   
   [Install]
   WantedBy=multi-user.target
   

3. 保存退出（按Ctrl+O回车，再按Ctrl+X）。

步骤3：安装依赖（若缺失） #

如果系统未安装xinit（启动X服务器的工具），执行：

sudo apt update && sudo apt install -y xinit

同时确认PySide2已正确安装，在pi用户下测试运行：

python3 /home/pi/GUI.py

确保程序能正常启动无报错。

步骤4：启用并测试服务 #

1. 重载systemd配置：

   sudo systemctl daemon-reload
   

2. 设置服务开机自启：

   sudo systemctl enable gui-start.service
   

3. 重启系统验证效果：

   sudo reboot
   

常见问题排查 #

• 若GUI无法显示，检查服务状态：

  sudo systemctl status gui-start.service
  

  查看日志中的错误信息，比如环境变量是否正确、程序路径是否有误。
• 若闪屏后出现命令行再弹出GUI，确保/boot/cmdline.txt保留quiet参数，屏蔽启动过程多余输出。
• 若遇到硬件访问权限问题（如GPIO、摄像头），可在服务的[Service]段添加：

  CapabilityBoundingSet=CAP_SYS_RAWIO
  

  并重新重载服务配置。

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