WSL2 + Linux + VSCode 远程开发完全指南 (Windows11 小白零基础搭建)

WSL2 + Linux + VSCode 远程开发完全指南 (Windows11 小白零基础搭建)

欢迎来到 WSL2 与 VSCode远程开发 的世界！本教程专为 Windows11 用户设计，手把手教你如何利用 Windows11 Linux子系统 实现高效的跨平台开发环境。无需虚拟机，无需双系统，直接在 Windows 上运行 Linux 并享受 VS Code 的强大编辑功能。无论你是前端、后端还是数据科学开发者，这套组合都能极大提升你的工作效率。

1. 什么是 WSL2？为什么选择它？

WSL2 (Windows Subsystem for Linux 2) 是微软推出的第二代 Linux 子系统，它使用真正的 Linux 内核，让开发者可以在 Windows 上运行原生 Linux 环境。相比第一代，WSL2 拥有完整的系统调用兼容性，文件系统性能大幅提升，并且与 Windows 完美集成。对于需要 Linux 环境的开发者来说，它是最轻量、最便捷的选择，也是实现跨平台开发的基石。

2. 开启 Windows 功能并安装 WSL2

在 Windows11 中，安装 WSL2 非常简单。首先，以管理员身份打开 PowerShell 或命令提示符，输入以下命令启用必要的功能：

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

然后重启电脑。重启后，再次打开 PowerShell，运行以下命令将 WSL2 设置为默认版本：

    wsl --set-default-version 2  

如果需要更新 WSL2 内核，请访问微软官方文档下载最新内核包。

3. 安装 Linux 发行版（以 Ubuntu 为例）

打开 Microsoft Store，搜索你喜欢的 Linux 发行版，例如 Ubuntu 22.04 LTS。点击安装。安装完成后，启动 Ubuntu，首次运行会提示创建用户名和密码，这个用户将成为 Linux 下的普通用户。之后你就可以在 Windows 终端中通过 wsl 命令随时进入 Linux 环境。

4. 安装 VSCode 及 Remote Development 插件

下载并安装 Visual Studio Code（简称 VS Code）。安装完成后，打开 VS Code，点击左侧活动栏的“扩展”图标，搜索并安装 Remote Development 扩展包（由微软官方提供）。这个扩展包包含了 Remote - WSL、Remote - SSH 和 Remote - Containers 等插件，其中 Remote - WSL 就是连接 WSL2 的关键。

5. 连接到 WSL2 进行开发

安装完 Remote Development 插件后，在 VS Code 左下角会出现一个绿色的远程连接图标（><）。点击它，选择“Remote-WSL: New Window”或“Remote-WSL: Open Folder in WSL”。如果尚未打开 WSL 中的文件夹，可以选择后者的方式，浏览到你 WSL 中的项目目录（例如 /home/用户名/project）。VS Code 会在 WSL 中启动一个服务器，并在本地窗口中以远程模式打开。此时，你可以在 VS Code 的终端中直接使用 Linux 命令，安装 npm、Python 等工具，所有操作都在 WSL2 环境中执行，而编辑体验与本地完全一致。

现在，你已经成功搭建了基于 WSL2 的 VSCode远程开发 环境！你可以利用 Windows11 Linux子系统 轻松运行 Linux 特有的工具链，同时享受 Windows 下的图形界面和 VS Code 的强大生态。这种跨平台开发模式已成为许多开发者的首选。

6. 总结与进阶

通过本教程，你应该已经掌握了在 Windows11 上使用 WSL2 和 VS Code 进行远程开发的基本流程。接下来可以探索更多高级用法，比如在 WSL2 中配置 Docker、使用多个发行版、或结合 Windows 和 Linux 的工具链。记住，WSL2 让 跨平台开发 从未如此简单。如果你遇到任何问题，欢迎在评论区留言讨论！