WSL的基本安装与配置

MoranisZ

I love you, like a pulse, like something hidden, like breathing.

Announcement

CCSwitch命令有变动，涉及CCS的文章暂未更新，请仔细核对

1618 words

8 minutes

WSL的基本安装与配置

2026-03-18

Usage Of WSL

Windows

/

WSL

/

Linux

WSL2 简介#

WSL（Windows Subsystem for Linux）是微软开发的一个兼容层，允许在 Windows 系统上原生运行 Linux 二进制可执行文件。WSL2 是 WSL 的第二代版本，使用真实的 Linux 内核，提供了更好的性能和完整的系统调用兼容性。

系统要求#

Windows 10 版本 2004 及更高版本（内部版本 19041 及更高版本）或 Windows 11
64 位处理器
至少 4GB 内存（推荐 8GB 或更多）
启用 BIOS 中的虚拟化功能

检查系统版本#

按 Win + R，输入 winver，查看 Windows 版本号。确保满足上述要求。

启用 WSL 功能#

方法一：使用 PowerShell（推荐）#

以管理员身份打开 PowerShell，执行以下命令：

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

4
# 启用虚拟机平台
5
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

执行完成后，重启计算机。

方法二：使用 Windows 功能#

打开”控制面板” → “程序” → “启用或关闭 Windows 功能”
勾选”适用于 Linux 的 Windows 子系统”
勾选”虚拟机平台”
点击”确定”，重启计算机

设置 WSL2 为默认版本#

重启后，以管理员身份打开 PowerShell，执行：

1
wsl --set-default-version 2

如果提示需要更新 WSL2 Linux 内核，请访问微软官方链接下载并安装。

安装 Ubuntu#

方法一：使用命令行（推荐）#

在 PowerShell 中执行：

1
# 查看可用的 Linux 发行版
2
wsl --list --online
3

4
# 安装 Ubuntu（默认最新 LTS 版本）
5
wsl --install -d Ubuntu
6

7
# 或安装指定版本
8
wsl --install -d Ubuntu-22.04

方法二：使用 Microsoft Store#

打开 Microsoft Store
搜索”Ubuntu”
选择需要的版本（如 Ubuntu 22.04 LTS）
点击”获取”或”安装”

首次启动配置#

安装完成后，启动 Ubuntu：

在开始菜单中找到并点击”Ubuntu”
首次启动会进行初始化，需要等待几分钟

系统会提示创建用户名和密码：

1
Enter new UNIX username: your_username
2
New password:
3
Retype new password:

注意：输入密码时不会显示任何字符，这是正常的安全机制。

基本配置#

更新系统#

首次进入 Ubuntu 后，建议先更新系统：

1
sudo apt update && sudo apt upgrade -y

配置国内镜像源（可选）#

为了提高下载速度，可以更换为国内镜像源（以阿里云为例）：

1
# 备份原有源
2
sudo cp /etc/apt/sources.list /etc/apt/sources.list.backup
3

4
# 编辑源文件
5
sudo nano /etc/apt/sources.list

将内容替换为：

1
deb http://mirrors.aliyun.com/ubuntu/ jammy main restricted universe multiverse
2
deb http://mirrors.aliyun.com/ubuntu/ jammy-security main restricted universe multiverse
3
deb http://mirrors.aliyun.com/ubuntu/ jammy-updates main restricted universe multiverse
4
deb http://mirrors.aliyun.com/ubuntu/ jammy-backports main restricted universe multiverse

保存后执行：

1
sudo apt update

安装常用工具#

1
# 安装基础开发工具
2
sudo apt install -y build-essential git curl wget vim
3

4
# 安装 zsh（可选）
5
sudo apt install -y zsh
6
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

WSL 常用命令#

Windows 端命令（PowerShell）#

1
# 查看已安装的发行版
2
wsl --list --verbose
3
wsl -l -v
4

5
# 启动默认发行版
6
wsl
7

8
# 启动指定发行版
9
wsl -d Ubuntu
10

11
# 关闭所有 WSL 实例
12
wsl --shutdown
13

14
# 关闭指定发行版
15
wsl --terminate Ubuntu
16

17
# 设置默认发行版
18
wsl --set-default Ubuntu
19

20
# 将发行版转换为 WSL2
21
wsl --set-version Ubuntu 2
22

23
# 卸载发行版
24
wsl --unregister Ubuntu
25

26
# 导出发行版
27
wsl --export Ubuntu D:\backup\ubuntu.tar
28

29
# 导入发行版
30
wsl --import Ubuntu D:\WSL\Ubuntu D:\backup\ubuntu.tar

Linux 端操作#

1
# 访问 Windows 文件系统
2
cd /mnt/c/Users/YourUsername
3

4
# 在 Windows 资源管理器中打开当前目录
5
explorer.exe .
6

7
# 在 WSL 中运行 Windows 程序
8
notepad.exe test.txt
9
code .

文件系统互访#

WSL 访问 Windows 文件#

Windows 的各个盘符挂载在 /mnt/ 目录下：

1
# C 盘
2
cd /mnt/c/
3

4
# D 盘
5
cd /mnt/d/

Windows 访问 WSL 文件#

在 Windows 资源管理器地址栏输入：

1
\\wsl$\Ubuntu\home\your_username

或者直接在 WSL 中执行 explorer.exe . 打开当前目录。

高级配置#

配置 .wslconfig（全局配置）#

在 Windows 用户目录下创建 .wslconfig 文件（C:\Users\YourUsername\.wslconfig）：

1
[wsl2]
2
# 限制内存使用
3
memory=4GB
4

5
# 限制处理器核心数
6
processors=2
7

8
# 交换空间大小
9
swap=2GB
10

11
# 关闭页面文件
12
pageReporting=false
13

14
# 设置虚拟硬盘大小限制
15
localhostForwarding=true

配置 wsl.conf（单个发行版配置）#

在 WSL 中编辑 /etc/wsl.conf：

1
sudo nano /etc/wsl.conf

添加以下内容：

1
[automount]
2
# 自动挂载 Windows 驱动器
3
enabled = true
4
root = /mnt/
5
options = "metadata,umask=22,fmask=11"
6

7
[network]
8
# 生成 /etc/resolv.conf
9
generateResolvConf = true
10
generateHosts = true
11

12
[interop]
13
# 启用 Windows 互操作
14
enabled = true
15
appendWindowsPath = true
16

17
[boot]
18
# 启动时执行的命令
19
command = service docker start

修改后需要重启 WSL：

1
wsl --shutdown

集成开发环境#

VS Code 集成#

在 Windows 中安装 VS Code
安装”Remote - WSL”扩展
在 WSL 中打开项目：

1
cd /path/to/your/project
2
code .

配置 Git#

1
# 配置用户信息
2
git config --global user.name "Your Name"
3
git config --global user.email "your.email@example.com"
4

5
# 配置凭据存储（与 Windows 共享）
6
git config --global credential.helper "/mnt/c/Program\ Files/Git/mingw64/bin/git-credential-manager.exe"

常见问题与解决方案#

1. WSL2 占用内存过高#

编辑 .wslconfig 文件限制内存使用（见上文高级配置）。

2. 网络连接问题#

如果无法访问网络，尝试：

1
# 重新生成 resolv.conf
2
sudo rm /etc/resolv.conf
3
sudo bash -c 'echo "nameserver 8.8.8.8" > /etc/resolv.conf'
4
sudo bash -c 'echo "nameserver 8.8.4.4" >> /etc/resolv.conf'

3. 磁盘空间清理#

1
# 清理 apt 缓存
2
sudo apt clean
3
sudo apt autoclean
4
sudo apt autoremove
5

6
# 在 Windows PowerShell 中压缩虚拟磁盘
7
wsl --shutdown
8
diskpart
9
# 在 diskpart 中执行：
10
select vdisk file="C:\Users\YourUsername\AppData\Local\Packages\CanonicalGroupLimited.Ubuntu_xxx\LocalState\ext4.vhdx"
11
compact vdisk
12
exit

4. 权限问题#

如果遇到文件权限问题，在 /etc/wsl.conf 中添加：

1
[automount]
2
options = "metadata,umask=22,fmask=11"

5. 无法启动 WSL#

1
# 重置网络
2
netsh winsock reset
3
netsh int ip reset all
4

5
# 重启 WSL 服务
6
wsl --shutdown

性能优化建议#

1. 项目文件存放位置#

推荐：将项目文件存放在 WSL 文件系统中（/home/username/），性能最佳
不推荐：通过 /mnt/c/ 访问 Windows 文件系统，性能较差

2. 使用 WSL2 而非 WSL1#

WSL2 提供更好的性能和兼容性：

1
wsl --set-version Ubuntu 2

3. 关闭不必要的服务#

1
# 查看运行的服务
2
service --status-all
3

4
# 停止不需要的服务
5
sudo service service_name stop

实用技巧#

1. 设置 Windows Terminal#

安装 Windows Terminal 以获得更好的终端体验：

从 Microsoft Store 安装”Windows Terminal”
自动识别 WSL 发行版
支持多标签、分屏等功能

2. 快速启动 WSL#

创建桌面快捷方式：

1
wsl.exe -d Ubuntu

3. 备份与迁移#

1
# 导出当前配置
2
wsl --export Ubuntu D:\backup\ubuntu-backup.tar
3

4
# 在新机器上导入
5
wsl --import Ubuntu D:\WSL\Ubuntu D:\backup\ubuntu-backup.tar --version 2

总结#

WSL2 为 Windows 用户提供了一个完整的 Linux 开发环境，无需双系统或虚拟机。通过合理配置，可以获得接近原生 Linux 的开发体验。建议将项目文件存放在 WSL 文件系统中以获得最佳性能，并根据实际需求调整内存和处理器限制。

参考资源#

WSL的基本安装与配置

https://paradoxmoranis.github.io/posts/wsl基本安装与使用/

Author

MoranisZ

Published at

2026-03-18

License

CC BY-NC-SA 4.0

中国大学生计算机科学学习路线推荐

MoranisZ Blog

WSL2 简介#

系统要求#

检查系统版本#

启用 WSL 功能#

方法一：使用 PowerShell（推荐）#

方法二：使用 Windows 功能#

设置 WSL2 为默认版本#

安装 Ubuntu#

方法一：使用命令行（推荐）#

方法二：使用 Microsoft Store#

首次启动配置#

基本配置#

更新系统#

配置国内镜像源（可选）#

安装常用工具#

WSL 常用命令#

Windows 端命令（PowerShell）#

Linux 端操作#

文件系统互访#

WSL 访问 Windows 文件#

Windows 访问 WSL 文件#

高级配置#

配置 .wslconfig（全局配置）#

配置 wsl.conf（单个发行版配置）#

集成开发环境#

VS Code 集成#

配置 Git#

常见问题与解决方案#

1. WSL2 占用内存过高#

2. 网络连接问题#

3. 磁盘空间清理#

4. 权限问题#

5. 无法启动 WSL#

性能优化建议#

1. 项目文件存放位置#

2. 使用 WSL2 而非 WSL1#

3. 关闭不必要的服务#

实用技巧#

1. 设置 Windows Terminal#

2. 快速启动 WSL#

3. 备份与迁移#

总结#

参考资源#