树莓派4开机自启含pyautogui的Python脚本报DISPLAY缺失如何解决

pyautogui依赖桌面X11服务的DISPLAY环境变量定位当前显示设备，你遇到的KeyError: 'DISPLAY'报错有两个核心原因：

1. 你当前用的自启方式执行时机早于树莓派桌面环境加载，X11服务还未启动，不存在DISPLAY变量
2. sudo命令默认会清空用户的环境变量，就算X11启动了，用sudo执行也会丢失DISPLAY变量

方案1：使用桌面自动启动（最推荐） #

这种方式会在桌面环境加载完成后自动执行脚本，时机最匹配pyautogui的运行要求：

• 执行以下命令创建当前用户的自启动配置文件：

mkdir -p ~/.config/autostart
nano ~/.config/autostart/pyautogui_task.desktop

• 写入以下配置，注意替换成你自己的脚本绝对路径：

[Desktop Entry]
Type=Application
Name=PyAutoGUI自动化脚本
Exec=python3 /home/pi/你的项目路径/main.py
Comment=开机自动运行pyautogui自动化任务
X-GNOME-Autostart-enabled=true

如果你的脚本必须要root权限运行，把Exec行替换为：

Exec=sudo DISPLAY=:0 python3 /home/pi/你的项目路径/main.py

• 保存退出后重启树莓派即可生效。

方案2：修改rc.local自启（适合需要早启动的场景） #

如果要保留rc.local的自启方式，需要手动注入环境变量：

• 编辑rc.local文件：

sudo nano /etc/rc.local

• 在exit 0之前插入以下内容，注意替换用户名和脚本路径：

export DISPLAY=:0
export XAUTHORITY=/home/pi/.Xauthority
nohup python3 /home/pi/你的项目路径/main.py &

• 保存退出重启即可。

• 必须开启树莓派的桌面自动登录，不要使用命令行启动模式，否则X11服务不会启动，pyautogui依然无法运行
• 所有路径必须写绝对路径，不能写相对路径（比如不能只写main.py）
• 可以在Python脚本开头加延迟，等桌面组件完全加载后再执行pyautogui逻辑，示例：

import time
time.sleep(3) # 可根据实际启动速度调整延迟时长
import pyautogui
pyautogui.moveTo(0,100)

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