Linux无GUI环境下使用Python控制鼠标失败该如何解决

你用到的mouse、pynput、pyautogui等库，底层都依赖运行中的X11/Wayland显示服务，无显示器的Linux环境默认不会启动这类GUI服务，所以所有调用图形服务接口的操作都会直接报错。

方案1：使用虚拟显示服务模拟GUI环境 #

这是改动最小的方案，不需要修改你之前写的Python代码，只需要在运行脚本前启动虚拟X服务即可：

• 先安装依赖包：
  Debian/Ubuntu系列执行：sudo apt install xvfb x11-utils xdotool
  RHEL/CentOS系列执行：sudo dnf install xorg-x11-server-Xvfb xdotool xorg-x11-utils
• 用虚拟显示服务启动你的Python脚本即可：
  xvfb-run -a python 你的脚本名.py
  这里的-a参数会自动分配可用的显示号，避免冲突。

方案2：直接使用xdotool操作（不需要Python） #

如果不需要复杂的业务逻辑，可以直接用xdotool完成鼠标移动、点击操作：

• 移动鼠标到指定坐标：xdotool mousemove x y（把x/y替换成实际坐标值）
• 左键单击：xdotool click 1
• 右键单击：xdotool click 3
• 针对特定窗口操作可以先查窗口ID：xdotool search --name "窗口名"，再指定窗口发送指令：xdotool mousemove --window 窗口ID x y click 1

方案3：针对无GUI的程序场景 #

如果你要操作的程序本身是无GUI的，只是需要模拟鼠标事件注入，可以直接操作内核输入子系统：

• 安装evemu工具：sudo apt install evemu-tools 或者 sudo dnf install evemu
• 先创建虚拟输入设备，再写入对应坐标、点击事件即可，不需要依赖任何显示服务。

• 如果是操作远程机器上的GUI程序，也可以开启SSH的X11转发，在执行ssh命令时加-X参数，将显示输出转发到本地有GUI的机器上，也能正常运行鼠标控制脚本。
• 所有需要和GUI交互的操作，都必须保证执行进程能读到DISPLAY环境变量，用xvfb-run启动的进程会自动设置该变量，手动操作的话可以执行export DISPLAY=:0（对应显示号0）再执行指令。

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