如何解决Python Tkinter报错：_tkinter.TclError: couldn't connect to display ":0.0"

问题场景 #

我用Python的Tkinter做数据可视化，代码如下：

import fdb
from tkinter import *
from PIL import ImageTk, Image
import numpy as np
import matplotlib
matplotlib.use('Agg')
import matplotlib.pyplot as plt

import sys
import os

if os.environ.get('DISPLAY','') == '':
    print('no display found. Using :0.0')
    os.environ.__setitem__('DISPLAY', ':0.0')

root = Tk()

def graph():
    plt.hist(total_orders, months)
    plt.show()

root.mainloop()

遇到的错误 #

运行后触发错误：

_tkinter.TclError: no display name and no $DISPLAY environment variable

尝试以下方案后仍未解决：

• 添加matplotlib.use('Agg')，无效，错误依旧
• 手动设置DISPLAY环境变量为:0.0，出现新错误：

  _tkinter.TclError: couldn't connect to display ":0.0"
  

• 安装x11-xserver-utils后运行xhost，提示：

  xhost:  unable to open display ""
  

解决方案 #

1. 区分运行环境处理 #

这个错误本质是程序无法找到可用的X11显示服务器，分两种场景处理：

• 本地桌面环境：确保系统正在运行图形界面，执行echo $DISPLAY检查输出（通常为:0或:0.0）。若输出为空，重启图形服务或重新登录桌面。
• 无桌面的服务器环境：
  • 若仅需生成图片而非实时显示：修改Matplotlib后端为Agg后，替换plt.show()为plt.savefig()保存图片，再通过Tkinter加载显示：

    def graph():
        plt.hist(total_orders, months)
        plt.savefig('temp_hist.png')
        plt.close()  # 释放内存资源
        # 用Tkinter加载生成的图片
        img = Image.open('temp_hist.png')
        img_tk = ImageTk.PhotoImage(img)
        label = Label(root, image=img_tk)
        label.image = img_tk  # 防止被垃圾回收机制销毁
        label.pack()
    

  • 若必须显示图形界面：配置X11转发
    1. 本地通过SSH连接服务器时添加-X参数：ssh -X user@server_ip
    2. 服务器端安装xauth，检查/etc/ssh/sshd_config中X11Forwarding设为yes，重启sshd服务：sudo systemctl restart sshd

2. 正确设置DISPLAY变量 #

不要在代码中硬编码DISPLAY值，让系统自动传递：

• 本地环境：确保图形界面启动后再运行脚本
• 远程转发场景：SSH带-X连接后，DISPLAY会自动设置为localhost:10.0这类有效格式

3. 解决Tkinter与Matplotlib后端冲突 #

用Tkinter作为GUI时，建议将Matplotlib后端设为TkAgg，直接在Tkinter窗口中嵌入图形，无需单独调用plt.show()：

import matplotlib
matplotlib.use('TkAgg')  # 替换原有的Agg后端
from matplotlib.backends.backend_tkagg import FigureCanvasTkAgg
import matplotlib.pyplot as plt

# 在graph函数中嵌入Matplotlib图形到Tkinter窗口
def graph():
    fig, ax = plt.subplots()
    ax.hist(total_orders, months)
    canvas = FigureCanvasTkAgg(fig, master=root)
    canvas.draw()
    canvas.get_tk_widget().pack()

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