WSL2下labelme无法打开？从WSLg到Qt依赖的排查指南

在 WSL2 里装 labelme，命令行敲下去，回车，屏幕一动不动——没报错，也没有任何窗口弹出来。这种情况我见过太多次了，包括我自己第一次在 WSL2 里折腾 labelme 的时候，也踩过这个坑。最气人的是，你去搜资料，网上答案五花八门，有的让你重装 WSL2，有的让你换 Windows 版本，折腾半天还是打不开。

其实 labelme 作为一个用 PyQt5 写的图像标注工具，本身出问题的概率很低，真正出问题的是它赖以运行的整条链路：WSL2 本身是否正常、WSLg 是否工作、显示相关的环境变量有没有配好、Qt 依赖库有没有装全、Python 环境有没有搞混。任何一个环节断了，窗口就出不来。这篇文章就按照我实际的排查顺序，从底层到应用层把每个环节过一遍，你可以照着一步步检查，基本能解决 90% 的同类问题。

1. 问题定位：GUI 应用起不来的四层故障面

在动手敲命令之前，先搞清楚一件事：labelme 打不开，到底“打不开”在哪一步？是命令压根没反应，还是刷了一屏报错，还是窗口闪了一下就消失？不同的表现对应不同的故障层面，定位错了方向，后面全是白折腾。

1.1 典型故障表现与对应层级

我遇到过的 labelme 在 WSL2 里打不开，基本可以归成四种情况：

你可以先对照这个表格，判断自己属于哪一类，再去翻后面对应的章节。不要一上来就重装 WSL2，那是下下策，而且大概率没用。

1.2 正确的排查顺序：从底层往上层走

我的建议是严格按照“WSL2 本体 → WSLg 显示服务 → Qt 依赖库 → Python 环境 → labelme 自身”这个顺序排查。原因很简单：上层的问题通常会在下层正常工作之后才暴露出来。

举一个我印象很深的例子。有个朋友在我之前那篇文章下面留言，说 labelme 装了三次都打不开，一直报 MSB 相关的错误，后来发现他 Windows 10 的版本太老，WSLg 功能根本没启用，窗口怎么可能弹出来？他装多少次 labelme 都没有用。

所以下面的章节，我按照这个顺序来写，你可以直接当成一份排查清单用。

2. 检查 WSL2 本体：虚拟化开关、WSLg 组件一个都不能少

labelme 打不开，第一步要确认的是 WSL2 本身工作正常。这里有两个容易忽略的地方：一个是 WSL2 到底有没有跑起来，另一个是 WSLg——也就是 Windows 自带的 Linux GUI 显示服务——是否可用。

2.1 虚拟化功能未启用的排查

在热搜词里经常能看到“WSL2 无法启动，因为此计算机上未启用虚拟化”这句话。如果你遇到的是这种情况，别说 labelme，连 WSL2 发行版本身都进不去，那就先解决这个问题。

具体做法是三步：

1. 在 Windows “控制面板 → 程序和功能 → 启用或关闭 Windows 功能”里，勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”这两项，注意“虚拟机平台”一定要勾上，不然 WSL2 没法用。
2. 勾选后重启 Windows。
3. 如果重启后仍然提示未启用虚拟化，需要进 BIOS/UEFI，找到 Intel VT-x（Intel 平台）或 AMD SVM（AMD 平台），把它设为 Enabled。

提示：这一步其实是很多“WSL2 里 GUI 应用打不开”的隐藏前置问题。因为即使 WSL2 能启动，如果虚拟化相关的 Windows 功能没有完全开启，后续 WSLg 也可能出现异常。

2.2 检查 WSL 版本和 WSLg 是否可用

确认虚拟化没问题后，在 Windows PowerShell 里运行：

powershell复制wsl --status

如果输出里有 “默认版本: 2” 或者类似的字样，说明 WSL2 正常。接下来验证 WSLg 是否工作。

WSLg 是