Windows11下WSL2中GUI程序（如matplotlib）模糊像素化问题求助

问题说明 #

在Windows 11的WSL2环境中运行TexStudio等GUI程序时，出现严重的模糊像素化问题，其中matplotlib的可视化内容模糊程度最高，几乎无法正常使用。偶尔点击图像区域会暂时恢复清晰，但切换到其他界面区域后又会回到模糊状态，保存功能也基本失效。

示例模糊效果：

• 模糊图像1：
• 模糊图像2：

已确认DISPLAY环境变量设置为:0（执行echo $DISPLAY输出为:0），且Windows 11自带WSL GUI支持无需额外安装X11，以下是针对性的解决方法：

1. 配置WSL2的高DPI参数 #

WSL2默认的DPI设置可能和Windows显示器不匹配，导致界面模糊：

• 在WSL用户目录下创建或编辑~/.wslconfig文件，添加以下内容（根据你的显示器实际DPI调整数值，比如192对应200%缩放）：

  [wsl2]
  guiApplications=true
  enableWindowingSystem=true
  dpi=96
  

• 保存文件后，在Windows终端执行wsl --shutdown关闭WSL，重新启动后生效。

2. 调整matplotlib的渲染与DPI设置 #

matplotlib的默认后端可能和WSL的显示兼容不佳，可通过修改配置解决：

• 先获取matplotlib配置文件路径，在WSL终端执行：

  python -c "import matplotlib; print(matplotlib.matplotlib_fname())"
  

• 编辑该配置文件，修改以下参数：

  backend: TkAgg  # 替换为Qt5Agg或TkAgg这类兼容WSL的后端
  figure.dpi: 96  # 和WSL配置的dpi数值保持一致
  savefig.dpi: 96
  

• 若不想修改全局配置，可在代码开头临时设置：

  import matplotlib.pyplot as plt
  plt.rcParams['backend'] = 'TkAgg'
  plt.rcParams['figure.dpi'] = 96
  

3. 调整Windows系统的高DPI缩放设置 #

Windows的缩放比例可能影响WSL GUI程序的显示：

• 打开Windows设置→系统→显示，找到“缩放”选项：
  • 若使用非100%缩放，尝试勾选“让Windows尝试修复应用，使其不模糊”；
  • 或者找到WSL GUI程序的快捷方式（比如TexStudio的快捷方式），右键→属性→兼容性→更改高DPI设置，勾选“替代高DPI缩放行为”，下拉菜单选择“应用程序”。

4. 更新WSL及系统组件 #

老旧版本的WSL内核可能存在显示兼容问题：

• 在Windows终端执行wsl --update更新WSL内核；
• 打开Windows设置→Windows更新→检查更新，确保系统为最新版本。

内容的提问来源于stack exchange，提问作者rj-may