WSL2 安装与使用指南:在 Windows 上跑 Linux 的完整教程

WSL(Windows Subsystem for Linux)让 Windows 用户无需虚拟机或双系统,就能直接在 Windows 上运行原生 Linux 环境。WSL2 采用真正的 Linux 内核,性能远超第一代,是科研和开发场景中在 Windows 上使用 Linux 工具链的最佳方案。

一、安装前的准备

系统要求

  • 操作系统:Windows 10(版本 2004+,内部版本 19041 及以上)或 Windows 11
  • 硬件:支持 Hyper-V 虚拟化的 64 位处理器
  • 可选:在 BIOS 中启用虚拟化(部分电脑出厂已开启)

查看 Windows 版本:Win + R 输入 winver,确认版本号不低于 19041。

二、一键安装(推荐)

以管理员身份打开 PowerShell 或 CMD,执行:

wsl --install

这条命令会自动完成以下操作:

  1. 启用「适用于 Linux 的 Windows 子系统」可选组件
  2. 启用「虚拟机平台」可选组件
  3. 下载并安装最新版 WSL Linux 内核
  4. 将 Ubuntu 设为默认发行版(可更改)
  5. 安装完成后提示重启电脑

重启后,系统会自动弹出 Ubuntu 的初始化窗口,设置用户名和密码即可完成安装。

指定发行版安装

如果不想使用 Ubuntu,可以先查看可用发行版:

wsl --list --online

然后指定发行版安装:

wsl --install -d Debian

常见发行版包括:Ubuntu、Debian、Kali Linux、openSUSE、Arch Linux 等。

三、手动安装

如果一键安装失败(网络问题或权限不足),可以手动分步执行:

步骤 1:启用 WSL 组件

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

步骤 2:启用虚拟机平台

dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

步骤 3:重启电脑

shutdown /r /t 0

步骤 4:下载并安装 WSL2 内核更新包

从微软官网下载 wsl_update_x64.msi(ARM 设备下载 wsl_update_arm64.msi),双击安装。

步骤 5:设置 WSL2 为默认版本

wsl --set-default-version 2

步骤 6:安装 Linux 发行版

打开 Microsoft Store,搜索并安装你喜欢的发行版(如 Ubuntu),首次启动时设置用户名和密码。

四、常用命令速查

命令功能
wsl启动默认发行版
wsl -d <发行版名>启动指定发行版
wsl --list --verbose查看已安装发行版及状态
wsl --set-default <发行版名>设置默认发行版
wsl --shutdown关闭所有运行中的实例
wsl --update更新 WSL 内核
wsl --status查看 WSL 运行状态
wsl --unregister <发行版名>注销并删除指定发行版

五、Windows 与 Linux 文件互访

从 Linux 访问 Windows 文件

Windows 的各盘符挂载在 /mnt/ 下:

# 访问 D 盘
cd /mnt/d/
ls

# 访问桌面
cd /mnt/c/Users/你的用户名/Desktop/

从 Windows 访问 Linux 文件

在文件资源管理器地址栏输入:

\\wsl$

或直接打开特定发行版:

\\wsl$\Ubuntu\home\

也可以在 WSL 终端中输入 explorer.exe . 直接用 Windows 资源管理器打开当前目录。

六、开发环境配置建议

换国内镜像源

Ubuntu 默认的软件源在国内较慢,建议替换为国内镜像:

# 备份原始源列表
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

# 替换为阿里云镜像(Ubuntu 24.04)
sudo sed -i 's|http://archive.ubuntu.com|http://mirrors.aliyun.com|g' /etc/apt/sources.list
sudo sed -i 's|http://security.ubuntu.com|http://mirrors.aliyun.com|g' /etc/apt/sources.list

# 更新索引
sudo apt update

安装常用开发工具

# 基础编译工具
sudo apt install build-essential git curl wget

# Python 环境
sudo apt install python3 python3-pip

# Node.js(通过 nvm)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install --lts

VS Code 远程开发

安装 VS Code 后,在 WSL 终端中执行:

code .

VS Code 会自动安装 Remote - WSL 扩展,实现无缝的远程开发体验——编辑器在 Windows 端运行,终端和文件系统在 Linux 端。

七、迁移到非系统盘

WSL 默认安装在 C 盘,如果 C 盘空间紧张,可以将发行版迁移到其他盘。

导出与导入

# 1. 关闭 WSL
wsl --shutdown

# 2. 导出为 tar 文件
wsl --export Ubuntu D:\wsl-backup\ubuntu.tar

# 3. 注销原有发行版
wsl --unregister Ubuntu

# 4. 导入到新位置
wsl --import Ubuntu D:\WSL\Ubuntu D:\wsl-backup\ubuntu.tar

# 5. 设置默认用户(否则默认为 root)
ubuntu config --default-user 你的用户名

修改默认安装位置

在安装前,可以通过配置文件指定 WSL 的默认安装位置。创建或编辑 %USERPROFILE%\.wslconfig

[wsl2]
# 限制内存使用
memory=4GB
# 限制处理器使用
processors=2
# 启用交换空间
swap=2GB

八、常见问题

安装报错 0x80070003

确保 Windows 版本满足要求,并已启用虚拟化。进入「任务管理器 → 性能 → CPU」查看虚拟化是否已启用。

网络连接失败

部分网络环境(如公司防火墙)可能阻止 WSL 下载。解决方案:

  1. 使用手动安装方式,提前下载好内核更新包和发行版
  2. 配置代理:export http_proxy=http://代理地址:端口

文件权限异常

/mnt/ 下操作 Windows 文件时,可能遇到权限问题。建议将项目文件放在 Linux 文件系统(/home/ 下)而非 Windows 磁盘上,以获得最佳性能和兼容性。

WSL2 占用内存过高

通过 .wslconfig 文件限制资源使用(见上文配置示例),配置后执行 wsl --shutdown 重启生效。

九、小结

WSL2 让 Windows 用户拥有了接近原生的 Linux 开发体验,是科研工作者在 Windows 环境下使用 Docker、Python、LaTeX 等工具链的高效方案。关键要点回顾:

  • 优先使用 wsl --install 一键安装
  • 项目文件放在 Linux 文件系统(/home/)中,性能更好
  • 搭配 VS Code Remote - WSL 扩展,获得最佳开发体验
  • C 盘空间不足时,通过导出/导入方式迁移到其他盘
返回博客列表