Windows 11 WSL + Ubuntu 24.04 安装指南

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 检查虚拟化是否开启

方法一:使用任务管理器
  1. 按下 Ctrl + Shift + Esc 打开任务管理器
  2. 点击「性能」选项卡
  3. 选择「CPU」
  4. 查看右下角是否显示「虚拟化: 已启用」
方法二:使用系统信息命令
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 发行版
  • 该命令执行以下操作:
    1. 启用「适用于 Linux 的 Windows 子系统」功能
    2. 启用「虚拟机平台」功能
    3. 下载并安装 WSL 2 Linux 内核
    4. 设置默认使用 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:等待安装完成

安装过程中自动执行:

  1. 下载 Ubuntu 24.04 镜像
  2. 创建 WSL 实例
  3. 解压文件系统
步骤 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:
  1. 输入用户名并按回车
  2. 设置密码(输入时不显示字符,Linux 安全机制)
  3. 再次输入密码确认
步骤 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 中:

  1. i 进入插入模式
  2. 输入上面的配置内容
  3. Esc 回到命令模式
  4. 输入 :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:

  1. 重启电脑
  2. 开机时按 F2/F10/Delete(具体看品牌提示)进入 BIOS/UEFI
  3. 找到「Virtualization Technology」或「Intel VT-x」/「AMD-V」选项
  4. 设为「Enabled」或「开启」
  5. 保存并重启

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 内运行):

    bash 复制代码
    echo 1 > /proc/sys/vm/drop_caches

Q4: 从 Windows 无法连接 WSL 中的服务?

A :

检查以下几点:

  1. WSL 是否在运行:wsl -l -v
  2. 服务是否在 WSL 中启动
  3. 防火墙状态:sudo ufw status(建议临时关闭:sudo ufw disable
  4. 服务绑定地址是否为 0.0.0.0
  5. 获取正确 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 &
相关推荐
王维同学2 小时前
[原创][Windows C++]LSA 认证、安全与通知包的注册表枚举
c++·windows·安全
YCOSA20253 小时前
雨晨 Windows 11 IOT 企业版 LTSC 24H2 轻装 2合1 26100.8968
windows·物联网
groundhappy3 小时前
idalib安装和codex ida-mcp配置
linux·开发语言·python
汤姆yu3 小时前
CodeGeeX 4完整安装与实操使用全指南
人工智能·windows·ai·智能体·视频模型
通信小小昕3 小时前
Ubuntu 26.04 中文输入法安装
linux·运维·ubuntu
张小姐的猫5 小时前
【Linux】网络编程 —— HTTP协议(上)
linux·运维·服务器·网络·http·单例模式·策略模式
栩栩云生5 小时前
AI 写代码犯的错,早被写进了错题集
linux·安全·ai编程
吐了啊取名字太难6 小时前
美颜系统AI修图本地跑并支持Mac、win、安卓、iOS不卡顿
android·人工智能·windows·数码相机·mac·ai编程
CedarQR6 小时前
万字长文:从零在 RK3588 上部署 PaddleSpeech 中文 TTS 全流程(FastSpeech2 + HiFiGAN)
开发语言·c++·嵌入式硬件·ubuntu·json
imc.116 小时前
linux基础IO
linux·运维·服务器