docker buildx ls 显示的 status 字段表示构建器实例当前是否活跃并就绪，如 running 表示后端 buildkit 已启动且平台支持完整，inactive 仅说明未被当前上下文激活而非损坏；platforms 列明所支持的目标架构，缺失则导致 --platform 构建失败。
docker buildx ls 显示的构建器状态代表什么
运行 docker buildx ls 后看到的列表，不是“有没有构建器”，而是“哪些构建器实例当前可用、是否活跃、后端是否就绪”。关键字段是 NAME、DRIVER、STATUS 和 PLATFORMS。比如你看到 default 构建器状态为 inactive，不代表它坏了，只说明它没被当前上下文激活；而 desktop-linux 状态为 running 才表示 Docker Desktop 内置的构建环境已就绪。
为什么 docker build 报错 “no builder found”
这不是镜像或命令写错了，而是构建器没启动或没设为默认。Docker Desktop 4.55.0 默认启用 buildx，但首次启动后不会自动激活构建器——它得等你第一次执行 docker build 或手动触发初始化。常见诱因包括：
- WSL2 后端未完全加载（
wsl -l -v显示docker-desktop是Running，但docker-desktop-data是Stopped） - 执行过
docker buildx stop但没再start - 手动切换过上下文（
docker context use），导致当前上下文不指向 Desktop 内置构建器 - 安装后没重启终端，
DOCKER_BUILDKIT=1环境变量未生效（新版仍依赖该变量启用 buildx 后端）
如何强制重建并验证 desktop-linux 构建器
别依赖“自动恢复”，直接重置最稳。以下命令需在 PowerShell 或 CMD 中以**普通用户权限**运行（不是管理员）：
docker buildx rm desktop-linux docker buildx create --name desktop-linux --use --bootstrap docker buildx inspect --bootstrap
注意三点：
-
--bootstrap参数必须带，否则构建器会创建但不拉取必要镜像（如moby/buildkit:buildx-stable-1） - 如果提示
error: could not create a builder instance，先检查wsl -l -v输出中docker-desktop-data是否为Running；不是就执行wsl -t docker-desktop-data && wsl -s docker-desktop-data -
docker buildx inspect最后一行显示Platforms: linux/amd64,linux/arm64才算真正就绪，缺平台说明 WSL2 内核版本太旧（需wsl --update）
构建器平台不匹配时的典型报错和绕过方式
当你用 docker buildx build --platform linux/arm64 构建 ARM 镜像，却收到 failed to solve: rpc error: code = Unknown desc = failed to solve with frontend dockerfile.v0: failed to create LLB definition: platform linux/arm64 is not supported by driver，本质是当前构建器没声明支持该平台。这不是配置问题，而是 WSL2 内核或 BuildKit 镜像版本不够新。解决路径很窄：
- 确认 WSL2 内核 ≥ 6.6.87（用
wsl --version查）；低于就wsl --update - 删掉旧 BuildKit 镜像：
docker rmi moby/buildkit:buildx-stable-1，再执行docker buildx create --use --bootstrap让它自动拉新版 - 临时绕过：改用
--platform linux/amd64构建，或加--load参数让 buildx 降级走本地 Docker daemon（但失去多平台能力）
构建器不是装完 Docker Desktop 就一劳永逸的东西，它的状态依赖 WSL2 实例、内核版本、BuildKit 镜像三者同步；任一环节滞后，docker build 就可能静默失败或报一堆看似无关的错误。
