Docker Desktop 只自动集成名为 docker-desktop 和 docker-desktop-data 的两个专用发行版，其他手动导入（如 wsl --import）的发行版默认不参与集成，除非显式配置名称、/etc/wsl.conf 启用 interop/automount/boot 等关键段落，并在设置中手动勾选启用。
直接说结论：Docker Desktop 无法集成你导入的 WSL 发行版，大概率不是发行版本身的问题，而是它没被识别为「可集成目标」——Docker Desktop 只自动集成 docker-desktop 和 docker-desktop-data 这两个专用发行版，其他手动导入（如用 wsl --import）的发行版默认不参与集成，除非你显式开启并配置。
为什么 wsl --import 的发行版不会自动集成
Docker Desktop 的 WSL 集成逻辑是白名单制，不是“所有运行中的发行版都接入”。它只监听两个硬编码名称的发行版：docker-desktop（运行 dockerd）和 docker-desktop-data（存储镜像/容器）。你用 wsl --import Ubuntu-24.04 /path/to/rootfs.tar.gz 导入的发行版，哪怕版本是 2、状态是 Running，Docker Desktop 根本不会尝试连接它。
常见错误现象包括：
- 在 Docker Desktop 设置 → Resources → WSL Integration 页面里，该发行版名称灰显、不可勾选
- 勾选后保存，重启 Docker Desktop，再打开设置发现又自动取消勾选
-
docker version在该发行版内能执行，但docker info报错Cannot connect to the Docker daemon
如何让自定义发行版真正参与 Docker Desktop 集成
必须满足三个条件：名称合法、/etc/wsl.conf 显式启用、Docker Desktop 设置中手动勾选并保存。缺一不可。
- 发行版名称不能含空格、下划线或特殊字符；推荐纯字母，如
ubuntu-dev、debian-build - 在该发行版内，编辑
/etc/wsl.conf，确保包含以下内容（不存在则新建）：[interop] enabled = true appendWindowsPath = false <p>[automount] enabled = true options = "metadata,uid=1000,gid=1000,umask=022,fmask=11"</p><p>[network] generateHosts = true generateResolvConf = true</p>
- 退出发行版，执行
wsl --shutdown，再重新启动该发行版（wsl -d ubuntu-dev），确保/etc/wsl.conf生效 - 打开 Docker Desktop → Settings → Resources → WSL Integration → 勾选对应发行版 → Apply & Restart
wsl --import 后立即检查的 3 个关键点
导入完成别急着开终端，先确认这三件事，能避开 80% 的“集成失败”假警报：
- 运行
wsl -l -v，确认该发行版 VERSION 是2（不是1），STATE 是Stopped或Running，而非Unknown - 在 PowerShell 中执行
wsl -d ubuntu-dev -- uname -r，输出应为类似5.15.133.1-microsoft-standard-WSL2；若报错The parameter is incorrect，说明内核未加载，需先wsl --shutdown再重试 - 检查该发行版是否被设为默认：
wsl --get-default；如果不是且你希望它作为主开发环境，运行wsl --set-default ubuntu-dev（不影响 Docker Desktop 集成，但影响日常wsl命令行为）
集成后仍提示 “unexpectedly stopped” 的真实原因
勾选并重启后，Docker Desktop 日志里还出现 WSL integration with distro 'ubuntu-dev' unexpectedly stopped，通常指向两个隐蔽问题：
-
/etc/wsl.conf中的[boot]段落缺失或配置错误：Docker Desktop 依赖该段落控制服务启动顺序，务必添加[boot] systemd = false
（WSL2 默认不启 systemd，设为 true 反而会冲突） - 发行版内
~/.docker/config.json被污染：尤其是credsStore或currentContext字段指向了已删除的上下文，会导致 Docker CLI 初始化失败，间接触发集成中断；可临时重命名该文件测试：mv ~/.docker/config.json ~/.docker/config.json.bak - 发行版根文件系统磁盘空间不足：WSL2 的 ext4.vhdx 文件写满时，Docker Desktop 无法写入 socket 或 runtime 目录，表现为集成“启动即停”；用
wsl -d ubuntu-dev df -h /检查使用率，超 95% 就得清理
最易被忽略的是 [boot] 段落缺失——它不像 [interop] 那样常被提及，但 Docker Desktop 的集成守护进程实际依赖它判断发行版是否准备好接收 Docker socket 挂载。
