WSL2运行Python tkinter程序报错：无法连接到显示设备127.0.0.1:0.0

一、Windows端X服务器配置校验（80%的问题出在这一步） #

• 优先使用VcXsrv，启动时必须勾选 Disable access control，不要用默认配置，否则会直接拒绝WSL子网的访问请求
• 启动后检查Windows防火墙：放行VcXsrv的 专用网络、公用网络 入站规则，Windows 11默认会把WSL的虚拟网卡识别为公用网络，没开权限会直接连不通
• 不要同时启动Xming和VcXsrv，二者默认都占用6000端口会冲突，启动前先杀残留进程：taskkill /im vcxsrv.exe /f、taskkill /im xming.exe /f，再单独启动VcXsrv

二、WSL端配置修正 #

• 先验证resolv.conf拿到的宿主机IP是否正确：执行 grep nameserver /etc/resolv.conf | awk '{print $2}'，输出的IP应该是WSL虚拟子网的宿主机网关，不能是127.0.0.1
• 你当前的DISPLAY动态获取写法没问题，确认配置是写在~/.zshrc末尾，写完执行source ~/.zshrc生效，执行echo $DISPLAY检查输出格式应为「网关IP:0.0」，如果是127.0.0.1开头说明动态获取逻辑失效
• 如果执行grep nameserver /etc/resolv.conf没有输出，说明你手动关闭了WSL自动生成resolv.conf的功能，改用ip route show default | awk '/default/ {print $3}'获取宿主机网关，替换DISPLAY配置即可，修改后为export DISPLAY=$(ip route show default | awk '/default/ {print $3}'):0.0
• 补全WSL端图形依赖：缺运行库也会触发该报错，执行 sudo apt install libx11-dev xauth x11-apps -y 安装依赖
• 基础连通性测试：执行xeyes，能弹出卡通眼睛窗口说明X服务器连通正常，再运行你的Python代码即可

三、VS Code WSL远程环境特殊配置 #

• VS Code的WSL终端默认可能不会加载~/.zshrc的全部配置，在VS Code设置中搜索「terminal.integrated.defaultProfile.linux」，选择zsh为默认终端即可解决
• 不要直接点击VS Code的运行按钮启动Python脚本，优先在WSL终端手动执行python3 你的文件名.py启动，避免VS Code运行环境没有加载DISPLAY变量
• 如果需要用VS Code运行/调试功能，在项目的launch.json的env字段手动添加DISPLAY变量，值和你终端echo $DISPLAY输出的内容完全一致即可

四、仍未生效的兜底方案 #

• 临时固定DISPLAY变量：先手动查到宿主机网关IP，比如网关为172.23.16.1，就直接执行export DISPLAY=172.23.16.1:0.0，跳过动态获取逻辑，避免resolv.conf读取异常
• 执行wsl --status确认你的发行版确实是WSL2，WSL1的网络栈和WSL2不通用，该配置对WSL1无效

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