问题背景
最近在尝试通过 Windows Subsystem for Linux (WSL) 安装 Ubuntu 时,遇到了一系列报错。最初的步骤是直接使用 wsl --install 命令,但安装完成后发现系统中并未自动安装默认的 Ubuntu 发行版。随后尝试通过命令行手动选择发行版,却提示 '无法找到指定的分发版'(Distribution not found)。本文将记录整个排查过程,最终通过 手动启用 Windows 功能 和 应用商店直接安装 的方式成功运行 WSL Ubuntu。
错误复现与初步排查
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 功能
- 打开 '控制面板' → '程序' → '启用或关闭 Windows 功能'。
- 勾选以下两项:
- '适用于 Linux 的 Windows 子系统'(核心 WSL 支持)。
- '虚拟机平台'(支持 WSL 2 的必要组件)。

- 点击 确定 后重启电脑。
步骤 2:通过 Microsoft Store 安装 Ubuntu
- 打开 Microsoft Store,搜索 'Ubuntu 22.04'。

- 点击 '获取' 下载并安装。


