WSL 安装与 Ubuntu 24.04 配置使用指南

WSL 安装与 Ubuntu 24.04 配置使用指南

目录

一、WSL 安装

1.1 启用 Windows 功能

以管理员身份打开 PowerShell，依次执行以下两条命令，完成后重启电脑。

# 启用 WSL 基础功能
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

# 启用虚拟机平台（WSL 2 必需）
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

备选方案：若命令执行失败，可通过 控制面板 → 程序 → 启用或关闭 Windows 功能，勾选 「适用于 Linux 的 Windows 子系统」 后重启。

1.2 安装 WSL 内核

推荐从 WSL 官方 GitHub Releases https://github.com/microsoft/WSL/releases 下载最新的 .msi 安装包，双击运行完成安装，速度优于 wsl –install或wsl –update –web-download 在线方式。

1.3 设置默认版本为 WSL 2

wsl —set-default–version 2

二、安装 Ubuntu 发行版

2.1 查看可用发行版

wsl —list —online

2.2 安装发行版（三种方式）

方式一：命令行在线安装

wsl —install –d Ubuntu-24.04

方式二：安装时直接指定存储路径（推荐，避免后续迁移）

wsl —install –d Ubuntu-24.04 —location "D:\\WSL\\Ubuntu-24.04"

方式三：从本地文件离线安装（从 Ubuntu 官网下载 .wsl 文件后）

wsl —install —from–file "D:\\wsl\\ubuntu-24.04.3-wsl-amd64.wsl"
—location "D:\\WSL\\Ubuntu-2404"
—name Ubuntu-24.04

备选方案：打开 Microsoft Store，搜索 Ubuntu 24.04 并安装，首次启动时按提示设置用户名和密码。

三、Ubuntu 基础配置

3.1 设置默认登录用户

若默认以 root 身份登录，可在 WSL 内修改配置文件来指定默认用户：

sudo nano /etc/wsl.conf

写入以下内容（将 your_username 替换为实际用户名）：

[user]
default=your_username

保存后，在 PowerShell 中执行以下命令重启 WSL 使配置生效：

wsl —shutdown

3.2 更换 apt 软件源（加速国内下载）

以清华大学 TUNA 镜像源为例，适用于 Ubuntu 24.04（代号 noble）。

第一步：备份原有源文件

sudo mv /etc/apt/sources.list /etc/apt/sources.list.bak

第二步：创建新的源配置文件

sudo nano /etc/apt/sources.list.d/tuna.sources

写入以下内容：

Types: deb
URIs: https://mirrors.tuna.tsinghua.edu.cn/ubuntu/
Suites: noble noble-updates noble-backports
Components: main universe restricted multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

Types: deb
URIs: https://mirrors.tuna.tsinghua.edu.cn/ubuntu/
Suites: noble-security
Components: main universe restricted multiverse
Signed-By: /usr/share/keyrings/ubuntu-archive-keyring.gpg

第三步：更新软件包列表

sudo apt update

3.3 启动 WSL 并登录 Ubuntu-24.04

启动方式

方式一：开始菜单

在 Windows 开始菜单搜索 Ubuntu 24.04，点击图标直接启动并进入 Shell。

方式二：PowerShell / 命令提示符

# 启动默认发行版
wsl

# 启动指定发行版
wsl –d Ubuntu-24.04

# 以指定用户登录
wsl –d Ubuntu-24.04 –u your_username

方式三：Windows Terminal

打开 Windows Terminal，点击标签栏 ＋ 旁的下拉箭头，选择 Ubuntu-24.04 即可直接开启一个新标签页并登录。

查看运行状态

# 查看所有已安装发行版及运行状态
wsl –l –v

输出示例：

NAME STATE VERSION
* Ubuntu-24.04 Running 2

退出与关闭

# 在 WSL 内退出当前会话（仅关闭终端窗口，WSL 后台仍在运行）
exit

# 停止指定发行版
wsl —terminate Ubuntu-24.04

# 停止全部 WSL 实例及虚拟机（彻底释放内存）
wsl —shutdown

提示：exit 只是退出 Shell 会话，WSL 虚拟机进程通常仍在后台运行。若需彻底释放内存，请在 PowerShell 中执行 wsl –shutdown。

四、迁移发行版至 D 盘

⚠️ 操作前请确保重要数据已备份。 注销步骤将永久删除原有安装。

4.1 方式一：导出 → 注销 → 重新导入（全版本通用）

步骤 1：导出当前发行版为 tar 备份包

# 先确保目标目录存在
mkdir D:\\WSLBackup

wsl —export Ubuntu-24.04 D:\\WSLBackup\\ubuntu24.tar

步骤 2：注销原发行版（从 C 盘删除）

wsl —unregister Ubuntu-24.04

步骤 3：将备份导入至 D 盘新路径

wsl —import Ubuntu-24.04 D:\\WSL\\Ubuntu24 D:\\WSLBackup\\ubuntu24.tar —version 2

导入后默认以 root 用户登录，需按 3.1 节 重新配置默认用户。

步骤 4：验证迁移结果

wsl –l –v
wsl –d Ubuntu-24.04

4.2 方式二：直接移动（WSL 较新版本支持）

wsl —manage Ubuntu-24.04 —move "D:\\WSL\\Ubuntu-24.04"

五、虚拟磁盘空间压缩

WSL 的虚拟磁盘（.vhdx）在删除文件后不会自动收缩，可按以下步骤手动压缩回收空间。

# 第一步：关闭所有 WSL 实例
wsl —shutdown

# 第二步：启动 diskpart 工具
diskpart

进入 diskpart 交互式窗口后，依次执行（路径根据实际情况修改）：

select vdisk file="D:\\WSL\\Ubuntu24\\ext4.vhdx"
attach vdisk readonly
compact vdisk
detach vdisk
exit

保存为脚本手动执行（推荐）

将 diskpart 指令保存为独立文件 compact-wsl.txt（内容如下），再通过 PowerShell 脚本统一调用，每次需要压缩时双击或直接运行即可。

compact-wsl.txt：

select vdisk file="D:\\WSL\\Ubuntu24\\ext4.vhdx"
attach vdisk readonly
compact vdisk
detach vdisk
exit

compact-wsl.ps1（以管理员身份运行）：

# 关闭所有 WSL 实例
wsl —shutdown
# 执行 diskpart 压缩脚本
diskpart /s "$PSScriptRoot\\compact-wsl.txt"
Write-Host "压缩完成。" –ForegroundColor Green

如需定期自动执行，可在 Windows 任务计划程序 中新建任务，操作设置为：程序 powershell.exe，参数 -ExecutionPolicy Bypass -File "D:\\scripts\\compact-wsl.ps1"。

六、常用命令速查

6.1 WSL 发行版管理（在 PowerShell 中执行）

6.2 Ubuntu 常用命令（在 WSL 内执行）

文件与目录

软件包管理

系统信息

6.3 WSL 与 Windows 互操作

在 Ubuntu 中调用 Windows 程序：

explorer.exe . # 在当前目录打开 Windows 文件资源管理器
notepad.exe file.txt # 用记事本打开文件
code . # 用 VS Code 打开当前目录（需安装 VS Code）

在 PowerShell 中执行 Linux 命令：

# 不进入 WSL 直接执行 Linux 命令
wsl –d Ubuntu-24.04 ls –lh /home
wsl –d Ubuntu-24.04 cat /etc/os-release

访问 WSL 文件系统：

• 在 Windows 文件资源管理器地址栏输入 \\\\wsl$\\Ubuntu-24.04 可直接访问 WSL 内的文件。
• WSL 中可通过 /mnt/c/、/mnt/d/ 等路径访问 Windows 各盘符。

日常使用提示

• 启动：开始菜单搜索 Ubuntu 点击，或在终端执行 wsl / wsl -d Ubuntu-24.04。
• 退出：WSL 内执行 exit 关闭当前会话；PowerShell 执行 wsl –shutdown 彻底停止所有 WSL 进程。
• 共享目录：将 Windows 下的项目目录软链或直接在 /mnt/ 下访问，可实现 Windows 与 WSL 工具链协同工作。