跳转至

实验0:WSL 安装教程

本节目标

完成 WSL 启用与 Ubuntu 子系统安装,掌握基础使用方式,并能通过 VS Code 连接开发环境。

适用范围

适用于 Windows 10 2004 及以上版本 / Windows 11,推荐安装 Ubuntu 24.04 LTS 作为子系统。

预计用时

若虚拟化功能已开启,且 wsl --install 能顺利执行,预计 10~20 分钟 即可完成;若还需要进入 BIOS/UEFI 开启虚拟化或排查 Windows 功能配置问题,时间可能更长。

1 启用 WSL 和虚拟化功能

  1. 确认已在 BIOS/UEFI 中开启虚拟化(一般名为Intel VT-xIntel VT-dAMD-V等,请参考博客来确认是否开启以及对应的开启方法)。
  2. 使用快捷键 windows键+R 打开运行对话框,输入optionalfeatures以后点击确定,即可打开“启用或关闭 Windows 功能”窗口

    img

  3. 在 “启用或关闭 Windows 功能”窗口中,勾选:

    • 适用于 Linux 的 Windows 子系统
    • 虚拟机平台

    点击确定后重启电脑。

    img

2 安装 WSL 依赖及 Ubuntu 子系统

  1. 在开始菜单中找到Windows PowerShell,选择以管理员身份运行

    img

  2. 在打开的窗口中输入指令 wsl --install,然后按下回车键执行。这一步会自动安装 WSL 所需依赖和最新版本的 Ubuntu,等待下载完成:

    img

  3. 按提示设置:

    • 创建一个 Linux 用户名(按照你的喜好设置即可);
    • 设置并确认密码(请务必记住该密码,后续使用sudo需要用到)。

    img

  4. 当出现最下面一行你设置的用户名@XXX:XXX的字样,即为安装完成。

3 如何使用 WSL 虚拟机

3.1 基础使用方法

在开始菜单搜索Ubuntu,直接打开即可。

img

打开后可以看到如下的终端界面,可以正常执行Linux命令。

img

3.2 VS Code 连接 WSL 虚拟机

上述方法可以正常使用 WSL 虚拟机,但只能使用 vim 编辑文件。为了更高效地编写代码,推荐使用 VS Code 连接 WSL 虚拟机。

  1. 打开 VS Code,在侧边栏选择扩展管理(图标如下图),安装 SSH 插件和 WSL 插件:

    img

    img

  2. 安装完成后重启 VS Code。此时侧边栏会出现远程资源管理器(图标如下图)。点击远程资源管理器,在右上角选择 WSL 目标,再点击 WSL 虚拟机侧边箭头,即可在当前窗口打开 WSL 虚拟机:

    img

  3. 下面简单介绍VS Code最基础用法,在主界面按住Ctrl + ~快捷键(~位于键盘左上角Esc键下方),即可打开命令行界面:

    img

  4. 在侧边栏选择资源管理器图标,然后点击打开文件夹,即可选择要打开的工作目录:

    img

  5. 打开工作目录以后,界面如下,就可以在左侧的资源管理器中选择需要编辑的文件,然后在右侧文件编辑区进行自由编辑:

    img

更多使用方法

此处仅介绍VS Code最基础的使用方法,VS Code是一个强大的编辑器,更多功能请各位同学自行网上学习。

4 基础环境与更新

首先需要配置软件源,请参照科大源官方教程配置。

在 WSL 终端中,更新一次系统软件包:

sudo apt update
sudo apt upgrade

由于这里使用了sudo指令,需要输入我们在第二节中设置的密码。

5 WSL 与 Windows 文件互访

  • 在 WSL 中,Windows 每个盘会挂载到/mnt目录下,例如:
    • C:盘对应/mnt/c
    • D:盘对应/mnt/d
  • 你可以在 WSL 中通过命令行访问和操作这些路径下的文件,例如:
    cd /mnt/c/Users/你的用户名/Desktop
    ls
    
  • 在 Windows 端,如果想用图形界面浏览当前 WSL 目录,可以在 WSL 终端中执行:
    explorer.exe .
    
    Windows 会在资源管理器中打开当前目录对应的位置。

6 完成检查

  • wsl -l -v 能看到 Ubuntu 发行版处于运行/可用状态。
  • 在 WSL 终端执行 uname -a 能正常输出 Linux 信息。
  • 能在 WSL 中执行 sudo apt update
  • 能通过 VS Code Remote-WSL 打开 WSL 内目录(可选但推荐)。

安装完成后看什么

现在你已经有了可用的 Linux 环境。若你还不熟悉命令行,建议继续看附录中的 Linux 基础教程。完成 实验0:内核编译运行与 GDB 调试 后,建议继续阅读 实验0:希冀平台与课程仓库接入;如需补充 Git 工作流,可再看 Git 提交、分支与合并