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

Windows 上安装 WSL Ubuntu 避坑指南：从报错到成功运行

Windows 系统安装 WSL Ubuntu 时常因功能未启用或版本过旧导致命令行安装失败。记录排查过程，建议手动启用适用于 Linux 的 Windows 子系统和虚拟机平台，并通过 Microsoft Store 下载 Ubuntu 22.04 镜像。安装后需配置用户名密码，使用 lsb_release 和 wsl -l -v 验证状态。若无法启动需检查 BIOS 虚拟化设置。应用商店安装方式自动化程度高，适合新手快速上手。

SparkGeek发布于 2026/3/16更新于 2026/6/737 浏览

问题背景

最近在尝试通过 Windows Subsystem for Linux (WSL) 安装 Ubuntu 时，遇到了一系列报错。最初的步骤是直接使用 wsl --install 命令，但安装完成后发现系统中并未自动安装默认的 Ubuntu 发行版。随后尝试通过命令行手动选择发行版，却提示 '无法找到指定的分发版'（Distribution not found）。本文将记录整个排查过程，最终通过 手动启用 Windows 功能 和 应用商店直接安装 的方式成功运行 WSL Ubuntu。

错误复现与初步排查

1. 初始操作步骤

  1. 以管理员身份打开 PowerShell 或 CMD。

尝试手动列出可用发行版并选择安装：

wsl --list --online # 查询可用的发行版名称
wsl --install --distribution Ubuntu-22.04 # 选择安装 Ubuntu 22.04

报错信息：

Error: 无法安装分发版，找不到指定的分发版。

执行命令安装 WSL：

wsl --install

预期结果：自动安装 WSL 核心组件并下载默认 Ubuntu 发行版。 实际结果：仅安装了 WSL 内核，但未安装任何 Linux 发行版。

2. 错误原因分析

  • WSL 功能未完全启用：某些 Windows 版本（如旧版 Windows 10）不会自动启用 WSL 所需的底层组件。
  • 系统未更新：若 Windows 版本过旧（低于 2004 版本），可能不支持直接通过命令行安装。
  • 网络或镜像源问题：微软服务器未响应，或本地网络阻止了发行版下载。

解决方案：手动启用 WSL 功能并安装 Ubuntu

步骤 1：启用 Windows 的 WSL 功能

  1. 打开 '控制面板' → '程序' → '启用或关闭 Windows 功能'。
  2. 勾选以下两项：
    • '适用于 Linux 的 Windows 子系统'（核心 WSL 支持）。
    • '虚拟机平台'（支持 WSL 2 的必要组件）。 启用 WSL 功能界面
  3. 点击 确定 后重启电脑。

步骤 2：通过 Microsoft Store 安装 Ubuntu

  1. 打开 Microsoft Store，搜索 'Ubuntu 22.04'。 应用商店搜索
  2. 点击 下载并安装。
'获取'
（此步骤会自动完成所有依赖配置，无需手动干预）
  • 安装完成后，从开始菜单启动 'Ubuntu 22.04'。
  • 首次启动配置：
    • 等待初始化完成（可能需要 1-2 分钟）。
    • 输入 用户名 和 密码（密码输入时无回显，正常输入后回车即可）。 首次启动配置

    • 步骤 3：验证安装结果

    在 Ubuntu 终端中检查系统信息：

    lsb_release -a

    输出示例：

    No LSB modules are available.
Distributor ID: Ubuntu
Description: Ubuntu 22.04.3 LTS
Release: 22.04
Codename: jammy

    在 PowerShell 中检查 WSL 状态：

    wsl -l -v

    输出应包含已安装的 Ubuntu 发行版和版本号：

     NAME STATE VERSION
* Ubuntu-22.04 Running 2

    常见问题与解决方法

    1. 安装后无法启动 Ubuntu（闪退或无响应）

    • 原因：WSL 2 需要启用虚拟化支持。
    • 修复：
      1. 进入 BIOS/UEFI 设置，启用 Intel VT-x 或 AMD-V 虚拟化技术。
      2. 在 PowerShell 中设置 WSL 默认版本为 2：
    wsl --set-default-version 2

    2. 应用商店下载速度慢

    • 原因：微软服务器网络波动。
    • 修复：
      • 使用网络加速工具。
      • 直接下载离线包（Ubuntu WSL 离线包）。

    为什么推荐通过应用商店安装？

    方式命令行安装应用商店安装
    自动化程度需手动启用功能、处理依赖全自动完成，适合新手
    发行版管理需记忆命令，易出错图形化操作，直观可靠
    更新维护需手动升级 WSL 内核自动接收微软商店的版本更新
    适用场景批量部署、开发者自定义需求个人用户快速上手

    总结

    通过本次踩坑经历，我们可以得出以下结论：

    1. WSL 功能依赖 Windows 组件：旧版系统需手动启用功能，否则命令行安装会失败。
    2. 应用商店是最省心的安装方式：尤其适合不熟悉命令行的用户。
    3. 验证安装结果必不可少：通过 wsl -l -v 和 lsb_release -a 确保一切正常。

    目录

    1. 问题背景
    2. 错误复现与初步排查
    3. 1. 初始操作步骤
    4. 2. 错误原因分析
    5. 解决方案：手动启用 WSL 功能并安装 Ubuntu
    6. 步骤 1：启用 Windows 的 WSL 功能
    7. 步骤 2：通过 Microsoft Store 安装 Ubuntu
    8. 步骤 3：验证安装结果
    9. 常见问题与解决方法
    10. 1. 安装后无法启动 Ubuntu（闪退或无响应）
    11. 2. 应用商店下载速度慢
    12. 为什么推荐通过应用商店安装？
    13. 总结
    • 💰 8折买阿里云服务器限时8折了解详情
    • Magick API 一键接入全球大模型注册送1000万token查看
    • 🤖 一键搭建Deepseek满血版了解详情
    • 一键打造专属AI 智能体了解详情
    极客日志微信公众号二维码

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

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

    更多推荐文章

    查看全部
    • 埃斯顿机器人编程快速入门指南
    • Ubuntu 国内镜像源更换指南：阿里/清华/中科大对比
    • MySQL 表约束核心指南：从基础到外键实战
    • OpenClaw 接入飞书：让 AI 直接操作文档和表格
    • OpenIM 开源即时通讯系统部署全流程解析
    • Obsidian AI 插件实战：Text Generator 配置与使用指南
    • 配置 Obsidian Git 插件实现笔记数据同步到 GitHub 仓库
    • 企业微信接入 AI 小助手：基于回调接口的群聊机器人实战
    • Ace-Translate 本地离线 AI 翻译工具使用指南
    • YOLOv8.3 无人机航拍小目标检测实战与优化策略
    • PentAGI AI 自动化渗透工具 Docker 部署指南
    • 垂直领域大模型微调实践经验总结
    • Dify 简介：低代码 AI 应用开发平台解析
    • Git 安全警告修复：解决 fatal: detected dubious ownership in repository at 错误
    • Java 多线程核心概念与机制总结
    • 大模型分布式训练与高效调参技术实战
    • 纯 Java 手写 TopoJSON 生成器：零依赖实现 GeoJSON 转换
    • 自主无人机硬件搭建与 EGOPlanner 部署实战
    • C++进阶：深入理解 unordered_set 与 unordered_map（含哈希表模拟实现）
    • Linux 深入理解文件系统

    相关免费在线工具

    • 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