Win10系统安装WSL2-Ubuntu, 并使用VScode开始工作

发布于:2025-04-13 ⋅ 阅读:(39) ⋅ 点赞:(0)

本教程基于博主当前需要使用 WSL2(Windows Subsystem for Linux 2) 而编写,将自己使用的经过分享给大家。有什么意见建议敬请大家批评指正。此过程需要打开 Microsoft Store
话不多说,立即开始~


1. 检查系统版本

WSL2 的 系统需求:
1. Win10 1903 或 更高版本(家庭版、专业版、企业版和教育版)
2. Win11 系统

如何检查是否满足要求?
1. 按下 win + R, 输入 winver 并回车
2. 弹出的窗口 关于Windows 中可查看版本号

简言之,就是只要是 Win10 或者 Win11 都满足要求


2. 启动 WSL 功能

下面是详细步骤

  • 控制面板 → \to 程序 → \to 程序和功能 → \to 启用或关闭 Windows 功能

启用或关闭 Windows 功能 按钮的位置

  • 在弹出窗口中勾选以下两项:
    • 适用于 Linux 的 Windows 子系统
    • 虚拟机平台

Note: 这两项几乎在最下边,进度条拖到最底往上翻找比较快

需要开启的两项功能

  • 之后点击确定,等待系统自动下载并安装所需组件,下载后 重启计算机

3. 安装Ubuntu

步骤:

  1. 找到 Microsoft Store (该应用但凡是Win系统都自带,找不到就去开始菜单里面找)
  2. 搜索栏输入 “Ubuntu”,点击回车后选择自己需要的版本
  3. 点击 “获取” 按钮 进行安装
  4. 安装完成后,开始菜单栏会出现 Ubuntu的图标,点击图标并进入
  5. 首次进入会设置用户名和密码,博主建议用户名密码设置一样

4. 设置 WSL2 为默认版本并更新

步骤:

  1. 以管理员身份运行 PowerShell
    PowerShell位置: Win10系统鼠标移动至开始按钮,单击右键即可看到, Win11操作步骤差不多
  2. 输入命令wsl --set-default-version 2并单击回车
  3. 输入命令wsl.exe --update更新(魔法能提高更新速度, 没有魔法速度可能会很慢)

5. WSL && VScode

该项需要下载 VScode,这就不提了~
接下来直接看 WSL2 连接 VScode的步骤

VScode方面: 需要安装插件:Remote - SSH, 直接搜 ssh 即可找到
WSL方面: 打开 Ubuntu 并输入命令: code ., 等待一段时间之后就会打开 VScode, 现在就可在VScode中工作了

之后需要在VScode中工作,可直接启动VScode,VScode会自动连接WSL。
若某次VScode与WSL断开的话,可以重复上述操作, 但是这种方法挺麻烦的,还有更简单的方案:

  1. 在 VScode中找到以下图标并点击
    ssh按钮位置
  2. 确保 远程资源管理器WSL 目标, 一般情况下设置好后并不会改变
  3. 鼠标移动到 Ubuntu 或者 相关文件夹名称上面
  4. 此时会显示图标 → \to , 点击即可进入。

6. 注意事项

  1. 安装过程中如果遇到权限问题, 确保使用 管理员 身份运行相关操作
  2. 如果系统提示 WSL 2 内核组件未安装,可尝试更新 Windows系统 或 手动下载安装 WSL 2 内核更新包
  3. 使用VScode过程中如果想要退出远程, 可点击VScode左下角蓝色文字 WSL: Ubuntu-**.04, 并在弹窗中选择关闭远程连接