WSL2与VSCode集成可实现Linux原生开发:安装WSL2并设为默认版本;安装Remote-WSL扩展;通过命令在WSL中打开项目;配置终端默认为WSL发行版;用gdb等调试Linux原生进程。

如果您在Windows系统中使用VSCode开发Linux环境下的项目,WSL(Windows Subsystem for Linux)可作为本地Linux运行时直接被VSCode识别和调用。以下是实现该集成的具体操作步骤:
本文运行环境:Surface Laptop 5,Windows 11。
一、安装并配置WSL2
WSL2提供完整的Linux内核兼容性与文件系统性能,是VSCode远程开发的基础运行环境。需确保启用虚拟机平台并安装指定发行版。
1、以管理员身份打开PowerShell,执行命令:wsl --install。
2、重启计算机完成安装。
3、启动已安装的Linux发行版(如Ubuntu),完成初始用户设置。
4、在PowerShell中运行:wsl --set-default-version 2,确保默认使用WSL2。
二、安装Remote-WSL扩展
该扩展由Microsoft官方维护,使VSCode能将工作区完全加载到WSL文件系统中,并复用其终端、调试器与包管理器。
1、打开VSCode,在扩展市场搜索Remote - WSL。
2、点击“安装”,等待扩展启用完成。
3、关闭所有VSCode窗口,重新启动。
三、在WSL中打开项目文件夹
通过VSCode内置命令可直接挂载WSL的Linux路径为工作区根目录,避免跨系统文件复制与权限错乱。
1、按Ctrl+Shift+P打开命令面板。
2、输入并选择:Remote-WSL: New Window。
3、在新窗口中,按Ctrl+K Ctrl+O打开文件夹。
4、导航至WSL路径,例如:/home/username/project,点击“确定”。
四、配置默认终端为WSL
将VSCode集成终端默认指向WSL实例,可直接运行Linux命令、npm脚本或Python解释器,无需手动切换。
1、打开VSCode设置(Ctrl+,),搜索terminal integrated default profile。
2、在下拉菜单中选择对应WSL发行版,例如:Ubuntu-22.04。
3、关闭设置页,新建终端(Ctrl+Shift+`),确认左下角显示WSL标识。
五、调试Linux原生进程
利用WSL的gdb或lldb调试器,配合VSCode的launch.json配置,可对C/C++或Rust程序进行原生级断点调试。
1、在WSL中安装调试工具:sudo apt install gdb。
2、在项目根目录创建.vscode/launch.json文件。
3、配置type字段为cppdbg,MIMode字段设为gdb。
4、在program字段中填写WSL路径下的可执行文件,例如:/home/username/project/build/app。










