如果您在 Windows 系统上进行 Linux 开发，但希望避免 虚拟机 或双系统的复杂配置，则 VSCode Remote – WSL 提供了一种直接在 Windows 中调用 WSL（Windows Subsystem for Linux）环境进行 编码、调试与运行的集成方案。以下是实现该集成的具体操作路径：
本文运行环境：Surface Laptop 5，Windows 11。
一、启用并安装 WSL
此步骤确保 Windows 底层具备运行 Linux 发行版的能力，是 Remote – WSL 功能的基础依赖。
1、以管理员身份打开 PowerShell，执行命令：wsl –install。
2、系统将自动启用相关 Windows 功能并下载默认发行版（通常为 Ubuntu）。
3、重启 计算机 后，在开始菜单中启动已安装的 Linux 发行版，完成初始用户账户设置。
二、安装适用于 WSL 的 VSCode 桌面版
必须使用支持 Remote – WSL 扩展的原生 Windows 版 VSCode，而非 WSL 内通过 apt 安装的 code-server 或 Linux 二进制版本。
1、访问 code.visualstudio.com，下载VS Code for Windows（.exe installer）。
2、运行安装程序，勾选“Add to PATH”和“Register Code as an editor for supported file types”选项。
3、安装完成后，从 Windows 开始菜单启动 VSCode，确认其运行于 Windows 宿主环境。
三、安装 Remote – WSL 扩展
该扩展负责建立 VSCode前端 界面与 WSL后端 环境之间的通信桥梁，使文件浏览、终端、调试器均指向 WSL 实例。
1、在 VSCode 中按 Ctrl+Shift+ X 打开扩展面板。
2、搜索关键词Remote – WSL，选择由 Microsoft 发布的官方扩展并点击 Install。
3、安装完毕后，右下角状态栏出现 WSL 指示图标，表明扩展已就绪。
四、通过 WSL 打开项目文件夹
此操作触发 VSCode 加载 WSL 上下文，所有后续操作（包括终端、任务、调试）均在 Linux 环境中执行。
1、点击 VSCode 左上角 File → Open Folder……。
2、在弹出窗口左侧导航栏中，点击WSL: Ubuntu（或其他已安装的发行版名称）。
3、进入 Linux 文件系统路径（如 /home/username/myproject），选择目标文件夹并点击 Select Folder。
五、验证 Linux 开发环境完整性
确认编辑器已正确桥接到 WSL，且核心开发 工具 链可被识别与调用。
1、按下 Ctrl+` 打开集成终端，观察提示符是否显示为 username@hostname:~$ 形式。
2、在终端中执行 gcc –version 或python3 –version，确认编译器与解释器可用。
3、新建一个。c 文件，编写简单 m ai n 函数，按 Ctrl+F5 启动调试，检查 GDB 是否成功附加到进程。
