当前位置：首页 > news >正文

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

news 来源：原创 2025/6/18 17:29:32

问题背景

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

错误复现与初步排查

1. 初始操作步骤

以管理员身份打开 PowerShell 或 CMD。
执行命令安装 WSL：
```
wsl --install
```
预期结果：自动安装 WSL 核心组件并下载默认 Ubuntu 发行版。
实际结果：仅安装了 WSL 内核，但未安装任何 Linux 发行版。

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

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

报错信息：

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 状态：
```
wsl -l -v
```
输出应包含已安装的 Ubuntu 发行版和版本号：
```
  NAME            STATE           VERSION
* Ubuntu-22.04    Running         2
```

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

lsb_release -a

输出示例：

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

常见问题与解决方法

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

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

2. 应用商店下载速度慢

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

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

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