WSL搭载Debian环境终端调用Matplotlib的plt.show()无法显示绘图怎么办？

核心问题原因 #

不需要单独安装Linux侧图像查看器，你遇到的问题是WSL默认没有内置X Window显示服务器，Linux侧GUI程序的绘图请求无法直接转发到Windows宿主系统的显示窗口，和block=True参数配置无关。

分步解决方法 #

• 第一步：配置Windows侧X服务器
  安装VcXsrv（Windows端免费X服务器工具），安装完成后启动，启动时勾选「Disable access control」选项，防火墙弹出提示时允许公共/专用网络访问。
• 第二步：配置Debian侧X11转发环境变量
  编辑~/.bashrc文件，在末尾添加以下内容：

  # WSL2 配置写法
  export DISPLAY=$(cat /etc/resolv.conf | grep nameserver | awk '{print $2}'):0
  export LIBGL_ALWAYS_INDIRECT=1
  

  如果你使用的是WSL1，DISPLAY变量直接替换为export DISPLAY=localhost:0即可。保存文件后执行source ~/.bashrc让配置生效。
• 第三步：安装Debian侧依赖包
  执行以下命令安装必要的GUI依赖和Matplotlib后端依赖：

  sudo apt update && sudo apt install -y x11-apps libxext-dev python3-tk
  

  安装完成后可以先运行xeyes命令测试，如果弹出带眼睛图标的窗口说明X11转发配置成功。
• 第四步：指定Matplotlib渲染后端
  在你的Python代码最开头添加以下内容，指定用TkAgg后端渲染：

  import matplotlib
  matplotlib.use('TkAgg')
  import matplotlib.pyplot as plt
  

  之后再运行你的绘图代码，就能正常弹出窗口显示图像了。

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