在 Windows 上安装 WSL Ubuntu 的完整避坑指南：从报错到成功运行 ...

标题背景​​

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

---

​​错误复现与初步排查​​

1. 初始操纵步骤

• 以管理员身份打开 ​​PowerShell​​ 或 ​​CMD​​。
  
• 实行下令安装 WSL：
  
  1. wsl --install

  复制代码
  预期效果：自动安装 WSL 焦点组件并下载默认 Ubuntu 发行版。
  实际效果：仅安装了 WSL 内核，但未安装任何 Linux 发行版。
  
• 实验手动列出可用发行版并选择安装：
  
  1. wsl --list --online                # 查询可用的发行版名称
  2. wsl --install --distribution Ubuntu-22.04  # 选择安装 Ubuntu 22.04

  复制代码
  报错信息：
  
  1. Error: 无法安装分发版，找不到指定的分发版。

  复制代码

---

2. 错误原因分析

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

---

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

步骤 1：启用 Windows 的 WSL 功能

• 打开 ​​“控制面板”​​ → ​​“程序”​​ → ​​“启用或关闭 Windows 功能”​​。
  
• 勾选以下两项：
  
  
  
  • ​​“实用于 Linux 的 Windows 子体系”​​（焦点 WSL 支持）。
    
  • ​​“虚拟机平台”​​（支持 WSL 2 的须要组件）。
    https://i.imgur.com/7yZg2jL.png
    
  
  
• 点击 ​​确定​​ 后重启电脑。
  

---

步骤 2：通过 Microsoft Store 安装 Ubuntu

• 打开 ​​Microsoft Store​​，搜索 ​​“Ubuntu 22.04”​​。
  https://i.imgur.com/9Vt8lBk.png
  
• 点击 ​​“获取”​​ 下载并安装。
  （此步骤会自动完成全部依赖配置，无需手动干预）
  
• 安装完成后，从开始菜单启动 ​​“Ubuntu 22.04”​​。
  
• ​​首次启动配置​​：
  
  
  
  • 等待初始化完成（可能需要 1-2 分钟）。
    
  • 输入 ​​用户名​​ 和 ​​暗码​​（暗码输入时无回显，正常输入后回车即可）。
    https://i.imgur.com/5G3kR7y.png
    
  
  

---

步骤 3：验证安装效果

• 在 PowerShell 中查抄 WSL 状态：
  
  1. wsl -l -v

  复制代码
  输出应包罗已安装的 Ubuntu 发行版和版本号：
  
  1.   NAME            STATE           VERSION
  2. * Ubuntu-22.04    Running         2

  复制代码
• 在 Ubuntu 终端中查抄体系信息：
  
  1. lsb_release -a

  复制代码
  输出示例：
  
  1. No LSB modules are available.
  2. Distributor ID: Ubuntu
  3. Description:    Ubuntu 22.04.3 LTS
  4. Release:        22.04
  5. Codename:       jammy

  复制代码

---

​​常见标题与解决方法​​

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

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

    复制代码
  
  

2. 应用市肆下载速度慢

• ​​原因​​：微软服务器网络颠簸。
  
• ​​修复​​：
  
  
  
  • 使用网络加速工具（如 Steam++、UsbEam Hosts Editor）。
    
  • 直接下载离线包（Ubuntu WSL 离线包）。
    
  
  

---

​​为什么推荐通过应用市肆安装？​​

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

---

​​总结​​

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

• ​​WSL 功能依赖 Windows 组件​​：旧版体系需手动启用功能，否则下令行安装会失败。
  
• ​​应用市肆是最省心的安装方式​​：尤其适合不认识下令行的用户。
  
• ​​验证安装效果必不可少​​：通过 wsl -l -v 和 lsb_release -a 确保统统正常。
  

假如你正在为 WSL 安装失败而苦恼，希望这篇指南能为你提供清楚的解决路径！

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。