Windows 11 WSL + Ubuntu 24.04 安装指南
本文档详细介绍如何在 Windows 11 上安装和配置 WSL 2 与 Ubuntu 24.04。
目录
- 一、系统要求检查
- [二、WSL 安装](#二、WSL 安装)
- [三、Ubuntu 24.04 初始化](#三、Ubuntu 24.04 初始化)
- [四、Ubuntu 系统配置](#四、Ubuntu 系统配置)
- [五、常用 WSL 命令速查](#五、常用 WSL 命令速查)
- 六、常见问题解答
一、系统要求检查
在开始之前,先确认你的电脑满足以下条件。
1.1 硬件要求
- 内存:建议至少 8GB(推荐 16GB 及以上)
- 存储空间:至少 20GB 可用空间(推荐 50GB+)
- 处理器:64 位处理器,支持二级地址转换(SLAT)
1.2 软件要求
- 操作系统:Windows 11(任意版本)或 Windows 10 版本 2004+
- BIOS/UEFI:需要开启虚拟化功能(VT-x/AMD-V)
1.3 检查虚拟化是否开启
方法一:使用任务管理器
- 按下
Ctrl + Shift + Esc打开任务管理器 - 点击「性能」选项卡
- 选择「CPU」
- 查看右下角是否显示「虚拟化: 已启用」
方法二:使用系统信息命令
powershell
# 以管理员身份打开 PowerShell 运行
systeminfo | findstr /i "虚拟化"
如果虚拟化未开启,重启电脑进入 BIOS/UEFI 设置中启用即可。
二、WSL 安装
2.1 启用 WSL 核心组件
步骤 1:以管理员身份打开 PowerShell
- 按下
Win + X,选择「Windows终端(管理员)」或「Windows PowerShell(管理员)」 - 安装 Windows 功能需要管理员权限
步骤 2:安装 WSL 核心组件
powershell
wsl --install --no-distribution
说明:
--no-distribution参数表示只安装 WSL 环境,不安装 Linux 发行版- 该命令执行以下操作:
- 启用「适用于 Linux 的 Windows 子系统」功能
- 启用「虚拟机平台」功能
- 下载并安装 WSL 2 Linux 内核
- 设置默认使用 WSL 2
注意:必须先执行此命令,之后才能查看可用的 Linux 发行版。
步骤 3:重启电脑
安装完成后,系统会提示重启,重启使更改生效。
为什么需要重启:
- 启用「虚拟机平台」功能需要重启才能完全生效
- 重启后 WSL 的底层基础设施才准备就绪
2.2 查看可用的 Linux 发行版
powershell
wsl --list --online
命令说明:
--list或-l:列出已安装或可用的发行版--online或-o:只显示可在线安装的发行版
输出示例:
以下是可安装的有效分发的列表。
请使用 "wsl --install -d <Distro>" 安装。
NAME FRIENDLY NAME
Ubuntu Ubuntu
Debian Debian GNU/Linux
kali-linux Kali Linux Rolling
Ubuntu-18.04 Ubuntu 18.04 LTS
Ubuntu-20.04 Ubuntu 20.04 LTS
Ubuntu-22.04 Ubuntu 22.04 LTS
Ubuntu-24.04 Ubuntu 24.04 LTS
...
2.3 安装 Ubuntu 24.04
步骤 1:执行安装命令
powershell
wsl --install -d Ubuntu-24.04
命令说明:
--install:安装新发行版-d或--distribution:指定发行版名称Ubuntu-24.04:要安装的发行版名称(注意大小写)
注意事项:
- 如果未指定
-d,默认安装普通 Ubuntu(非 24.04 版本) - 安装过程会下载镜像,需等待数分钟
步骤 2:等待安装完成
安装过程中自动执行:
- 下载 Ubuntu 24.04 镜像
- 创建 WSL 实例
- 解压文件系统
步骤 3:确认默认 WSL 版本(可选)
powershell
wsl --set-default-version 2
WSL 2 的优势:
- 性能提升 3-5 倍(文件系统操作)
- 完整 Linux 内核支持
- 支持 Docker 等容器技术
- 更好的系统调用兼容性
2.4 其他安装方式
选项 A:安装到指定目录
powershell
# 方式一:直接指定安装位置(推荐)
# 安装时直接写入指定目录,无需后续迁移
wsl --install -d Ubuntu-24.04 --location D:\wsl_dir
# 方式二:先下载不启动
wsl --install -d Ubuntu-24.04 --no-launch
# 方式三:手动导出/导入(适合迁移已有发行版)
wsl --export Ubuntu-24.04 D:\wsl\ubuntu-24.04.tar.gz
wsl --import Ubuntu-24.04 D:\wsl\Ubuntu-24.04 D:\wsl\ubuntu-24.04.tar.gz
适用场景:C 盘空间不足时使用。
命令说明:
--location <目录>:指定安装目录(Windows 路径)--export:将发行版导出为 tar 文件(备份)--import:从 tar 文件导入发行版
选项 B:使用 WSL 1
powershell
# 启用 WSL 1 支持(通常已默认启用)
wsl --install --enable-wsl1
# 将指定发行版切换为 WSL 1
wsl --set-version Ubuntu-24.04 1
适用场景:
- 需要大量访问 Windows 文件系统时,WSL 1 可能更快
- 特定软件与 WSL 2 不兼容时
选项 C:从本地文件安装
powershell
# 从已下载的 tar 文件导入
wsl --import Ubuntu-24.04 D:\wsl\Ubuntu-24.04 D:\downloads\ubuntu-24.04.tar.gz
适用场景:网络受限,已提前下载镜像文件。
三、Ubuntu 24.04 初始化
3.1 首次启动配置
步骤 1:启动 Ubuntu
powershell
wsl -d Ubuntu-24.04
或者从开始菜单启动「Ubuntu 24.04」。
步骤 2:创建用户账户
首次启动会提示:
Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
Enter new UNIX username:
- 输入用户名并按回车
- 设置密码(输入时不显示字符,Linux 安全机制)
- 再次输入密码确认
步骤 3:验证安装
bash
# 查看 Ubuntu 版本
lsb_release -a
# 查看 Linux 内核版本
uname -r
# 查看根目录
ls -la /
四、Ubuntu 系统配置
4.1 更新软件包
步骤 1:更新软件包列表
bash
sudo apt update
说明:
- 更新前先刷新软件包信息,确保获取最新版本
sudo:以管理员(root)权限执行apt:Ubuntu 软件包管理器update:只更新列表,不安装软件
步骤 2:升级已安装的软件包
bash
sudo apt upgrade -y
说明:
upgrade:升级已安装的软件包到最新版本-y:自动确认所有提示
4.2 配置国内镜像源(推荐)
为什么要换源
| 对比项 | 默认源(archive.ubuntu.com) | 清华镜像源 |
|---|---|---|
| 服务器位置 | 国外 | 国内(北京) |
| 下载速度 | 较慢(几十 KB/s) | 较快(可达数 MB/s) |
| 稳定性 | 一般 | 较稳定 |
结论:国内用户强烈推荐替换为清华镜像源,可大幅提升下载速度。
Ubuntu 24.04 配置文件说明
从 Ubuntu 24.04 开始,软件源配置文件格式变更:
- 旧版本:
/etc/apt/sources.list - 新版本:
/etc/apt/sources.list.d/ubuntu.sources(DEB822 格式)
先确认系统版本:
bash
# 查看是否有新格式配置文件
ls -la /etc/apt/sources.list.d/
# 查看 Ubuntu 版本
cat /etc/os-release | grep VERSION_CODENAME
输出应包含 VERSION_CODENAME=noble,其中 noble 是 Ubuntu 24.04 的代号。
步骤 1:备份原配置文件
bash
# 备份新格式配置文件(Ubuntu 24.04+)
sudo cp /etc/apt/sources.list.d/ubuntu.sources /etc/apt/sources.list.d/ubuntu.sources.backup
步骤 2:写入清华镜像源配置
bash
sudo tee /etc/apt/sources.list.d/ubuntu.sources << 'EOF'
Types: deb
URIs: https://mirrors.tuna.tsinghua.edu.cn/ubuntu
Suites: noble noble-updates noble-backports
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
# 默认注释源码镜像以提高 apt update 速度,需要时可取消注释
# Types: deb-src
# URIs: https://mirrors.tuna.tsinghua.edu.cn/ubuntu
# Suites: noble noble-updates noble-backports
# Components: main restricted universe multiverse
# Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
# 安全更新使用官方源
Types: deb
URIs: http://security.ubuntu.com/ubuntu/
Suites: noble-security
Components: main restricted universe multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
# Types: deb-src
# URIs: http://security.ubuntu.com/ubuntu/
# Suites: noble-security
# Components: main restricted universe multiverse
# Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg
EOF
命令说明:
tee:同时写入文件和输出到屏幕<< 'EOF':多行输入模式,EOF为结束标记
使用 vim 编辑的替代方式:
bash
sudo vim /etc/apt/sources.list.d/ubuntu.sources
在 vim 中:
- 按
i进入插入模式 - 输入上面的配置内容
- 按
Esc回到命令模式 - 输入
:wq保存退出
步骤 3:验证配置
bash
cat /etc/apt/sources.list.d/ubuntu.sources
确认输出中包含 mirrors.tuna.tsinghua.edu.cn。
步骤 4:测试速度
bash
sudo apt update
如果更新速度明显提升,说明配置成功。
4.3 安装常用工具
bash
sudo apt install -y curl wget vim git net-tools
工具说明:
| 工具 | 用途 |
|---|---|
curl |
命令行 HTTP 客户端,用于下载文件、测试接口 |
wget |
专门的下载工具,支持多种协议 |
vim |
Linux 经典文本编辑器 |
git |
版本控制工具 |
net-tools |
网络工具集(包含 netstat、ifconfig 等) |
4.4 网络配置
查看 WSL IP 地址
bash
ip addr show eth0
输出示例:
3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000
link/ether 00:15:5d:12:34:56 brd ff:ff:ff:ff:ff:ff
inet 172.27.123.45/20 brd 172.27.127.255 scope global eth0
172.27.123.45 即 WSL 的 IP 地址。
从 WSL 内部查看 Windows 主机 IP
bash
cat /etc/resolv.conf | grep nameserver
输出中的 nameserver 即为 Windows 主机 IP。
4.5 文件系统互相访问
从 WSL 访问 Windows 文件
bash
# Windows C 盘挂载在 /mnt/c/
cd /mnt/c/Users/你的用户名/Desktop
# Windows D 盘挂载在 /mnt/d/
ls /mnt/d/
说明:
- Linux 所有文件在根目录
/下 /mnt/是挂载外部设备的传统目录- WSL 自动挂载 Windows 驱动器
从 Windows 访问 WSL 文件
方法一:在文件资源管理器地址栏输入
\\wsl$\Ubuntu-24.04
方法二:在 WSL 中直接打开
bash
explorer.exe .
此命令会直接在 Windows 资源管理器中打开当前目录。
五、常用 WSL 命令速查
5.1 基础命令
| 命令 | 说明 | 示例 |
|---|---|---|
wsl |
启动默认发行版 | wsl |
wsl -d <名称> |
启动指定发行版 | wsl -d Ubuntu-24.04 |
wsl -u <用户> |
以指定用户运行 | wsl -u root |
wsl --list |
列出已安装发行版 | wsl -l -v |
wsl --list --online |
列出可在线安装的发行版 | wsl -l -o |
5.2 发行版管理
| 命令 | 说明 | 示例 |
|---|---|---|
wsl --install -d <名称> |
安装新发行版 | wsl --install -d Ubuntu-24.04 |
wsl --install --no-distribution |
只安装 WSL 核心组件 | wsl --install --no-distribution |
wsl --set-default <名称> |
设置默认发行版 | wsl -s Ubuntu-24.04 |
wsl --set-default-version <版本> |
设置默认 WSL 版本 | wsl --set-default-version 2 |
wsl --set-version <名称> <版本> |
切换发行版的 WSL 版本 | wsl --set-version Ubuntu-24.04 2 |
wsl --terminate <名称> |
关闭指定发行版 | wsl -t Ubuntu-24.04 |
wsl --unregister <名称> |
注销/删除发行版 | wsl --unregister Ubuntu-24.04 |
wsl --export <名称> <文件> |
导出发行版(备份) | wsl --export Ubuntu-24.04 D:\backup.tar |
wsl --import <名称> <位置> <文件> |
导入发行版(恢复) | wsl --import Ubuntu-24.04 D:\wsl D:\backup.tar |
注意 :--unregister 会删除所有数据,谨慎使用。
5.3 在 WSL 中运行命令
| 命令 | 说明 | 示例 |
|---|---|---|
wsl <命令> |
在 WSL 中运行命令 | wsl ls -la |
wsl -e <命令> |
不启动 shell 直接执行 | wsl -e vim |
wsl --cd <目录> |
指定工作目录 | wsl --cd /mnt/c/Users |
5.4 WSL 系统管理
| 命令 | 说明 | 示例 |
|---|---|---|
wsl --shutdown |
关闭所有 WSL 实例 | wsl --shutdown |
wsl --status |
查看 WSL 状态 | wsl --status |
wsl --version |
查看 WSL 版本 | wsl -v |
wsl --update |
更新 WSL | wsl --update |
5.5 实用组合命令
powershell
# 查看所有发行版详细信息(含版本号)
wsl -l -v
# 以 root 身份进入
wsl -d Ubuntu-24.04 -u root
# 在 WSL 中运行命令后返回 Windows
wsl -d Ubuntu-24.04 -- echo "Hello from WSL"
# 快速重启某个发行版
wsl -t Ubuntu-24.04; wsl -d Ubuntu-24.04
# 备份发行版到文件
wsl --export Ubuntu-24.04 D:\wsl_backup\ubuntu-24.04-20240101.tar
# 查看 WSL 状态和资源占用
wsl --status
# 查看 WSL 版本
wsl -v
六、常见问题解答
Q1: 安装 WSL 时提示「需要启用虚拟化」怎么办?
A:
- 重启电脑
- 开机时按 F2/F10/Delete(具体看品牌提示)进入 BIOS/UEFI
- 找到「Virtualization Technology」或「Intel VT-x」/「AMD-V」选项
- 设为「Enabled」或「开启」
- 保存并重启
Q2: 运行 wsl --list --online 报错找不到发行版?
A :
需要先执行 wsl --install --no-distribution 安装核心组件,正确顺序:
powershell
# 第一步:安装 WSL 核心组件
wsl --install --no-distribution
# 重启电脑
# 第二步:查看可用发行版
wsl --list --online
# 第三步:安装
wsl --install -d Ubuntu-24.04
Q3: WSL 启动很慢?
A:
-
确认使用 WSL 2:运行
wsl -l -v查看 -
如果不是,切换到 WSL 2:
wsl --set-version Ubuntu-24.04 2 -
释放 WSL 内存(在 WSL 内运行):
bashecho 1 > /proc/sys/vm/drop_caches
Q4: 从 Windows 无法连接 WSL 中的服务?
A :
检查以下几点:
- WSL 是否在运行:
wsl -l -v - 服务是否在 WSL 中启动
- 防火墙状态:
sudo ufw status(建议临时关闭:sudo ufw disable) - 服务绑定地址是否为
0.0.0.0 - 获取正确 IP:
wsl -d Ubuntu-24.04 -- ip addr show eth0
Q5: WSL IP 每次重启都变怎么办?
A :
可使用 Windows 端口转发功能:
powershell
# 获取 WSL IP
$wslIp = wsl -d Ubuntu-24.04 -- ip addr show eth0 | grep "inet\b" | awk '{print $2}' | cut -d/ -f1
# 添加端口转发(以 Redis 的 6379 端口为例)
netsh interface portproxy add v4tov4 listenport=6379 listenaddress=0.0.0.0 connectport=6379 connectaddress=$wslIp
# 查看转发规则
netsh interface portproxy show all
# 删除转发规则
netsh interface portproxy delete v4tov4 listenport=6379 listenaddress=0.0.0.0
Q6: 如何完全卸载 WSL Ubuntu?
A:
powershell
# 方式一:注销发行版(保留文件,可重新导入)
wsl --unregister Ubuntu-24.04
# 方式二:彻底删除(包含所有数据)
wsl --unregister Ubuntu-24.04
# 然后手动删除 C:\Users\你的用户名\AppData\Local\Packages\ 下的相关文件夹
Q7: 如何在 WSL 中运行 systemctl?
A :
WSL 2 默认不支持 systemd,但可尝试两种方式:
bash
# 方式一:使用 service 命令
sudo service redis-server start
# 方式二:安装 systemd 支持(不推荐,可能不稳定)
sudo apt install systemd
sudo systemd --user &