WSL2（Windows11）下启动Meld持续报错，功能正常但会崩溃

系统环境 #

~$ uname -a
Linux NJ-LPT-06 5.15.90.1-microsoft-standard-WSL2 #1 SMP Fri Jan 27 02:56:13 UTC 2023 x86_64 x86_64 x86_64 GNU/Linux

• Windows 11 + WSL2，所有组件已更新
• DISPLAY环境变量设置为:0

问题现象 #

启动Meld后程序表面功能正常，但控制台批量抛出以下AttributeError，且错误会间歇性重复出现；长时间运行或重载更新后的文件时，程序会直接中止。

报错信息：

AttributeError: 'NoneType' object has no attribute 'get_allocation'
Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 201, in do_size_allocate
    self._handle1.set_visible(mapped and wlink1 > 0)
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 288, in set_visible
    self._window.show()
AttributeError: 'NoneType' object has no attribute 'show'
Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 232, in do_draw
    self._handle1.draw(context)
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 305, in draw
    alloc = self._widget.get_allocation()
AttributeError: 'NoneType' object has no attribute 'get_allocation'
Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 53, in do_unmap
    self._handle1.set_visible(False)
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 290, in set_visible
    self._window.hide()
AttributeError: 'NoneType' object has no attribute 'hide'
Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 53, in do_unmap
    self._handle1.set_visible(False)
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 290, in set_visible
    self._window.hide()
AttributeError: 'NoneType' object has no attribute 'hide'
Traceback (most recent call last):
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 38, in do_unrealize
    self._handle1.unrealize()
  File "/usr/lib/python3/dist-packages/meld/diffgrid.py", line 284, in unrealize
    self._widget.unregister_window(self._window)
AttributeError: 'NoneType' object has no attribute 'unregister_window'

解决方法 #

1. 强制使用X11后端启动Meld #

WSL2中GTK应用默认可能尝试使用Wayland后端，导致窗口对象初始化异常。启动时指定X11后端：

GDK_BACKEND=x11 meld

如果有效，可将该环境变量加入shell配置文件（如~/.bashrc或~/.zshrc）：

echo "export GDK_BACKEND=x11" >> ~/.bashrc
source ~/.bashrc

2. 更新Meld到最新版本 #

旧版本Meld可能存在WSL2环境下的兼容性bug，通过官方PPA升级（适用于Debian/Ubuntu系）：

sudo add-apt-repository ppa:meld-maintainers/stable
sudo apt update && sudo apt install --only-upgrade meld

3. 手动修复diffgrid.py的空值判断 #

若无法更新Meld，可直接修改报错的diffgrid.py文件，为涉及self._window和self._widget的方法增加空值检查：

修改set_visible方法（约287行）：

原代码：

def set_visible(self, visible):
    if visible:
        self._window.show()
    else:
        self._window.hide()

修改为：

def set_visible(self, visible):
    if not self._window:
        return
    if visible:
        self._window.show()
    else:
        self._window.hide()

修改draw方法（约304行）：

原代码：

def draw(self, context):
    alloc = self._widget.get_allocation()
    # 后续代码...

修改为：

def draw(self, context):
    if not self._widget:
        return
    alloc = self._widget.get_allocation()
    # 后续代码...

修改unrealize方法（约283行）：

原代码：

def unrealize(self):
    self._widget.unregister_window(self._window)
    self._window = None

修改为：

def unrealize(self):
    if self._widget and self._window:
        self._widget.unregister_window(self._window)
        self._window = None

修改后保存文件，重启Meld即可。

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