wsl integration开关灰掉说明docker desktop未检测到可用的wsl2发行版或wsl2未就绪；需确认wsl -l -v输出至少一个state为running且version为2的发行版，并确保wsl --status显示default version: 2和wsl service: running，否则开关将被禁用。
WSL integration 开关灰掉或根本没显示
这说明 Docker Desktop 没检测到可用的 WSL2 发行版，或者它压根没识别出 WSL2 已就绪。不是界面 bug，而是底层依赖链断在了前几环。
先确认最基础的两件事：wsl -l -v 必须输出至少一个 VERSION 为 2 且 STATE 不是 Stopped 的发行版；wsl --status 应返回 Default Version: 2 和 WSL Service: Running。如果这两条任一不满足，Settings 里的 WSL integration 标签页就会被禁用。
- 运行
wsl --update确保内核是最新的（尤其 Win11 23H2 用户，旧内核有已知兼容问题） - 执行
wsl --set-default-version 2，哪怕你只装了一个发行版，也得显式指定 - 如果
wsl -l -v输出为空，说明 WSL 功能根本没启用：用管理员 PowerShell 运行dism /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart和dism /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart，然后必须重启 - 某些 OEM 预装系统（如戴尔、联想出厂 Win11）会默认关闭 BIOS 虚拟化，此时
wsl --status可能报WSL Service: Not running，需进 BIOS 手动开启 VT-x/SVM
开关开着但点 Apply 后自动关闭或报错
常见于已安装多个发行版（比如 Ubuntu、Ubuntu-24.04、docker-desktop-data），但 Docker Desktop 试图集成的那个发行版状态异常。它不会告诉你具体是哪个出问题，只会默默关掉开关。
关键检查点是发行版的 STATE 和用户权限。Docker Desktop 默认尝试集成名为 Ubuntu 的发行版，但如果该发行版处于 Stopped 状态，或其 /home/<user></user> 目录权限混乱（比如被 Windows 权限策略覆盖），就会触发静默失败。
- 运行
wsl -t Ubuntu再wsl -d Ubuntu，确认能正常进入且whoami和ls -ld ~显示用户目录属主正确 - 若
Ubuntu已被删或重命名，改用实际存在的发行版名：在 Settings → WSL integration 页面勾选对应条目，例如Ubuntu-24.04 - 避免使用中文用户名或含空格路径的 Windows 账户登录 WSL，这类账户常导致 Docker Desktop 初始化
.docker目录失败，进而拒绝集成 - 删除
%USERPROFILE%\AppData\Local\Docker\wsl\data\下残留的锁文件（如lock或ext4.vhdx.lock），再重启 WSL：wsl --shutdown
集成后容器启动报 failed to write file: exit status 0xffffffff
这是典型的 WSL 发行版内文件系统权限/挂载异常，和开关本身是否打开无关，但容易误判为“集成失败”。错误来自 Docker CLI 尝试写入 ~/.docker/config.json 或上下文目录时被拒绝，根源几乎总是 ext4.vhdx 文件损坏或 ACL 锁死。
Docker Desktop 在 WSL 中运行时，会把 Windows 用户的 %USERPROFILE% 挂载为 /mnt/c/Users/<name></name>，但它自己用的 docker-desktop-data 卷是独立的 ext4.vhdx。一旦这个虚拟磁盘因强制关机、磁盘空间满或杀毒软件干扰而损坏，所有写操作都会返回这个模糊错误码。
- 不要直接修改
docker-desktop-data卷内容，用wsl --export docker-desktop-data backup.tar备份后，再wsl --unregister docker-desktop-data彻底清除 - 重新启动 Docker Desktop，它会自动重建
docker-desktop-data和docker-desktop两个发行版 - 若仍报错，临时切换回 Hyper-V 后端验证：Settings → General → Use the WSL 2 based engine（取消勾选），看是否能启动容器——如果可以，问题 100% 在 WSL2 数据卷
- Windows Defender 实时保护有时会锁定 ext4.vhdx，可临时添加
%LOCALAPPDATA%\Docker\wsl\到排除列表测试
Win11 23H2 下集成开关偶尔闪退或设置丢失
这不是 Docker Desktop 的 UI 崩溃，而是 Windows 11 23H2 引入的 VBS（基于虚拟化的安全）与 WSL2 内核存在已知调度冲突。当系统启用了内存完整性（Memory Integrity）或核心隔离（Core Isolation），WSL2 服务可能在后台被随机终止，导致 Docker Desktop 读取 WSL 状态时超时，从而重置 UI 设置。
这种问题不会立刻报错，而是表现为：刚点开 Settings 勾上 Ubuntu，切出去再回来发现又变灰；或者隔几分钟自动退出 WSL 集成状态。日志里通常夹杂 WSL service stopped unexpectedly 和 CommandTimedOut。
- 按
Win+R输入gpedit.msc→ 计算机配置 → 管理模板 → 系统 → Device Guard → 关闭 “Turn on Virtualization Based Security” - 或更直接：PowerShell（管理员）运行
Set-ProcessMitigation -System -Disable EnableUAC,EnableCFG,EnableDEP,EnableSEHOP（仅用于开发机，勿用于生产环境） - 禁用后必须重启，且要确认
core isolation在 Windows 安全中心 → 设备安全性 → 核心隔离中已关闭 - 微软已在 2026 年 10 月累积更新 KB5038xxxx 中修复此问题，确保系统已安装最新补丁
真正卡住人的地方，从来不是“要不要开那个开关”，而是开关背后那套由 BIOS 虚拟化、Windows 功能开关、WSL2 内核版本、发行版状态、ext4.vhdx 健康度、VBS 策略共同构成的隐式依赖链。任何一个环节松动，都会让 UI 表现得像坏了，其实只是它诚实拒绝了不完整的输入。
