基石百科

Windows 10 安装 WSL 2 + Ubuntu 24.04 LTS 完整技术教程

nazhan 11 0

教程概述

本教程针对 Windows 10 系统,详细讲解如何解决网络、内核等常见问题,成功安装 WSL 2(适用于 Linux 的 Windows 子系统)并部署 Ubuntu 24.04 LTS(长期支持版),全程适配国内网络环境,新手友好。

一、前置条件Windows 版本要求:Windows 10 2004 版(内部版本 19041)及以上,或 Windows 11 任意版本;操作权限:需以管理员身份运行 PowerShell;网络:可访问外网(离线安装方案可绕过)。

二、详细安装步骤步骤 1:启用 WSL 和虚拟机平台核心功能右键开始菜单 → 选择「Windows PowerShell (管理员)」;执行以下命令启用功能(无需重启,后续统一重启):

# powershell 终端命令 # 启用适用于Linux的Windows子系统 dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart # 启用虚拟机平台(WSL 2必需) dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

步骤 2:安装 WSL 2 内核更新包(解决 0x800701bc 错误)

这是解决「WSL 2 缺少内核」核心步骤,国内直接手动下载:

下载地址:https://wslstorestorage.blob.core.windows.net/wslblob/wsl_update_x64.msi;双击安装包,全程点击「下一步」,无需修改默认设置;安装完成后重启电脑(功能和内核生效必需)。步骤 3:设置 WSL 2 为默认版本

重启后,再次以管理员身份打开 PowerShell,执行:

# powershell 终端命令 wsl --set-default-version 2

成功提示:已成功将默认版本设置为 2。

若仍报错:确认步骤 2 的内核包已安装,重启后重试。

步骤 4:解决网络更新错误(0x80072eff/0x80244022)

国内环境下wsl --update易因网络问题失败,直接跳过更新,采用「离线安装 Ubuntu」方案:

方案 A:微软应用商店安装(简单,推荐)打开 Microsoft Store → 搜索「Ubuntu 24.04 LTS」;点击「获取」,等待安装完成后点击「启动」;首次启动会自动配置 WSL 2 环境,提示设置Linux 用户名和密码(记好密码,sudo 权限需要)。方案 B:离线导入安装(无网络 / Store 访问失败时)下载 Ubuntu 24.04 离线包:https://cloud-images.ubuntu.com/releases/24.04/release/ubuntu-24.04-server-cloudimg-amd64-wsl.rootfs.tar.gz;在 PowerShell 中创建安装目录:

# powershell 终端命令 mkdir C:WSLUbuntu2404

导入离线包为 WSL 分发版(替换下载路径):

wsl --import Ubuntu-24.04 C:WSLUbuntu2404 C:UsersadminDownloadsubuntu-24.04-server-cloudimg-amd64-wsl.rootfs.tar.gz --version 2

启动 Ubuntu 并创建普通用户(避免 root 登录):

wsl -d Ubuntu-24.04

进入 Ubuntu 终端后执行(替换yourname为自定义用户名):

useradd -m -s /bin/bash yourname # 创建用户 passwd yourname # 设置密码 usermod -aG sudo yourname # 赋予管理员权限 echo -e "[user]ndefault=yourname" > /etc/wsl.conf # 设置默认登录用户

重启 WSL 生效:

wsl --terminate Ubuntu-24.04 wsl -d Ubuntu-24.04 # 重新启动,自动登录新用户

三、验证安装结果

在 PowerShell 中执行以下命令,确认状态正常:

wsl -l -v

成功输出示例:

NAME STATE VERSION * Ubuntu-24.04 Running 2

四、Ubuntu 首次配置(必做)

启动 Ubuntu 终端(PowerShell 输入wsl),完成基础配置:

1. 更新系统包

sudo apt update && sudo apt upgrade -y

2. 配置中文环境(可选)

# 安装中文语言包 sudo apt install -y language-pack-zh-hans language-pack-zh-hans-base # 设置系统语言为中文 sudo update-locale LANG=zh_CN.UTF-8

配置后执行wsl --shutdown重启 WSL,重新进入终端即显示中文。

3. 安装常用工具(按需选择)

# 文本编辑器(nano简单,vim功能强) sudo apt install -y nano vim # 网络工具(ping/curl/wget) sudo apt install -y iputils-ping curl wget # 开发工具(git/gcc/python) sudo apt install -y git gcc g++ python3 python3-pip

五、常用操作命令汇总1. Windows PowerShell 端(管理 WSL)

2. Ubuntu 终端端(操作 Linux 系统)

六、常见问题及解决方案

错误代码 / 现象

原因

解决方案

0x800701bc

缺少 WSL 2 内核更新包

安装官方内核包(步骤 2)+ 设置 WSL 2 为默认版本

0x80072eff/0x80244022

网络无法访问微软更新服务器

采用离线安装 Ubuntu 方案(步骤 4)

Ubuntu 内执行wsl -l -v提示找不到命令

wsl是 Windows 命令,不能在 Linux 内执行

切换到 PowerShell 执行wsl -l -v

WSL 版本过旧,wsl --version无效

系统内置旧版 WSL

手动安装 WSL 应用包(步骤 4 方案 B)

七、核心总结安装核心:先启用 WSL / 虚拟机平台 → 安装 WSL 2 内核 → 设置默认版本为 2 → 安装 Ubuntu;国内适配:优先用「应用商店安装 Ubuntu」,网络报错时选择「离线导入」;关键验证:wsl -l -v显示 Ubuntu 状态为Running、版本为2即安装成功;首次配置:更新系统包是必做步骤,可按需配置中文和开发工具。

至此,你已完成 WSL 2 + Ubuntu 24.04 LTS 的完整安装和配置,可正常使用 Linux 命令、开发工具,且能无缝访问 Windows 文件系统(如/mnt/c对应 Windows C 盘)。

标签: