跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
PowerShell

WSL 版本过旧导致 Docker Desktop 无法启动的解决方法

Docker Desktop 依赖 WSL 2 环境,若提示版本过旧,通常因未安装 WSL、内核未更新或虚拟化未开启所致。解决步骤包括确认 Windows 版本支持、启用 WSL 及虚拟机平台功能、更新 WSL 内核并将默认版本设为 2。若遇内存不足,可配置 wslconfig 文件限制资源。

星落发布于 2026/2/5更新于 2026/6/114K 浏览

在安装 Docker Desktop 时遇到这个问题,是因为 Docker Desktop 依赖 Windows Subsystem for Linux (WSL) 2 提供的轻量级虚拟化环境,而你当前的 WSL 版本过旧(可能是 WSL 1 或未更新的 WSL 2 内核),无法满足 Docker Desktop 的运行要求。

具体原因可能包括:

  1. WSL 未安装或版本过低:系统中未启用 WSL 功能,或安装的是旧版 WSL 1(Docker Desktop 需要 WSL 2);
  2. WSL 2 内核未更新:即使已安装 WSL 2,其内核组件可能未升级到最新版本;
  3. 虚拟化功能未启用:Windows 未开启 Hypervisor Platform 或相关虚拟化支持(如 Intel VT-x/AMD-V)。

解决方法需先通过 wsl --update 命令更新 WSL 内核,确保启用 WSL 2 并配置为 Docker Desktop 的默认后端。若问题持续,需检查 Windows 版本(需 ≥19041)、启用 Hyper-V 及 WSL 功能,并安装最新 WSL 2 内核更新包。

文章配图

一、先确认 Windows 版本是否支持 WSL 2

WSL 2 需要 Windows 10 版本 2004(内部版本 19041)或更高,或 Windows 11。

  • 按 Win + R,输入 winver → 查看弹出窗口中的版本号(如'版本 22H2 内部版本 22621.xxx')。
  • 如果版本低于 19041,需先通过 Windows Update 升级系统(设置 → 更新和安全 → Windows Update)。
二、启用 WSL 和虚拟机平台功能
  1. 以管理员身份打开 PowerShell(右键开始菜单 → 选择'Windows PowerShell (管理员)')。
  2. 重启电脑 使功能生效。

运行以下命令启用 WSL 和虚拟机平台(两条命令需依次执行):

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
三、更新 WSL 至最新版本(关键步骤)

方法 1:自动更新(推荐) 以管理员身份打开 PowerShell,运行:

wsl --update

该命令会自动下载并安装最新 WSL 内核。

方法 2:手动安装内核更新包 如果自动更新失败,可手动下载官方内核包:

  • 下载地址:WSL2 Linux 内核更新包(x64 版本)
  • 下载后双击安装,按提示完成操作。
四、将 WSL 默认版本设为 2
  1. 验证版本:运行 wsl -l -v,若已安装 Linux 发行版(如 Ubuntu),其'VERSION'列应显示为 2。
  • 虚拟化未启用:进入 BIOS/UEFI(开机时按 F2/F10/Del 等键,不同主板不同),找到'虚拟化技术'(Intel VT-x/AMD-V)并启用。
  • 内存不足处理:在 %UserProfile%/.wslconfig 文件中添加内存限制(若文件不存在则新建):

    [wsl2]
    memory=4GB # 根据系统内存调整,建议至少 4GB
    swap=2GB
    

    手动点击 Restart 重启服务,最终效果如下成功进入。

    文章配图

    常见问题排查

    打开 PowerShell(无需管理员权限),运行:

    wsl --set-default-version 2
    

    执行完成后重启 WSL 即可生效。若仍有问题,请检查 Windows 更新及 BIOS 虚拟化设置是否完全正确。

    目录

    1. 一、先确认 Windows 版本是否支持 WSL 2
    2. 二、启用 WSL 和虚拟机平台功能
    3. 三、更新 WSL 至最新版本(关键步骤)
    4. 四、将 WSL 默认版本设为 2
    5. 常见问题排查
    • 💰 8折买阿里云服务器限时8折了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

    微信扫一扫,关注极客日志

    微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

    更多推荐文章

    查看全部
    • Java JDK 21 安装与环境配置教程(Windows + macOS 通用)
    • 在国内环境部署 OpenClaw 个人 AI 助手搭建指南
    • UltraScale FPGA 系统管理向导配置与温压监测实战
    • Pico 4XVR 1.10.13 安装与使用指南
    • 基于 OpenClaw 框架搭建自动化 AI 选股系统
    • Python 异步数据汇聚与并行计算框架设计与实现
    • Python 装饰器详解:概念、类型与应用场景
    • 通义万相 2.1:多模态生成模型的技术架构与应用场景解析
    • Python 聚类实战:OPTICS 算法原理与可视化全流程
    • Pi0 机器人大模型在昇腾 A2 上的部署与性能测评
    • IDEA Maven 运行时报错 Picked up JAVA_TOOL_OPTIONS 编码问题解决方法
    • ComfyUI 安装指南:国内网络加速与 GitHub 配置
    • 基于 AutoGPT 与 Python 的 AI 智能体开发实战
    • MCP Document Reader:AI 助手读取本地文档工具
    • AI 实践:Skills 技能详解
    • Windows 本地部署 Ollama 与 OpenClaw 构建 AI 生产力系统
    • DepRadar:基于多智能体协作的深度学习库缺陷检测框架
    • C++ 包管理工具 vcpkg 配置国内镜像源
    • Django+Vue3 前后端分离 Web 视觉系统:集成 YOLO 与 LLM 大模型智能分析
    • Dify 与 MySQL 深度融合实战:基于 MCP 协议的数据交互指南

    相关免费在线工具

    • Base64 字符串编码/解码

      将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

    • Base64 文件转换器

      将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

    • Markdown转HTML

      将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online

    • HTML转Markdown

      将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML转Markdown在线工具,online

    • JSON 压缩

      通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online

    • JSON美化和格式化

      将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online