Windows10安装Kivy运行报错Couldn't connect to X server求助

根因定位 #

从报错日志的/mnt/c/路径、GCC编译标识可以判断，你当前在WSL（Windows子系统Linux）环境中运行Python程序，Kivy作为GUI框架需要X服务器提供图形渲染能力，默认WSL未配置X服务所以抛出Couldn't connect to X server错误。你此前安装的pypiwin32等Windows端依赖在WSL Linux环境中完全不生效，属于环境匹配错误。

解决方案 #

方案1：修复WSL环境配置 #

• 在Windows端安装VcXsrv X服务器工具，启动时勾选禁用访问控制选项，允许WSL进程连接
• 回到WSL终端执行如下命令添加X服务环境变量：

echo "export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0.0" >> ~/.bashrc
source ~/.bashrc

• 安装WSL端必要的图形依赖包：

sudo apt update && sudo apt install -y libx11-dev xorg-dev

• 重新激活Kivy虚拟环境，运行python main.py即可正常启动

方案2：切换到Windows原生Python环境（操作更简单，无额外依赖配置） #

• 关闭WSL终端，直接在Windows的PowerShell/CMD中创建全新虚拟环境：

python -m venv kivy_venv
kivy_venv\Scripts\activate

• 重新安装Kivy相关依赖：

python -m pip install --upgrade pip wheel setuptools
python -m pip install kivy[base] kivy_examples

• 执行python main.py，程序会直接调用Windows原生图形接口运行，不会触发X服务相关报错

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