VSCode与WSL 2组合可提供接近原生Linux的开发体验,需依次完成WSL 2安装初始化、Remote - WSL插件配置、VSCode设置与扩展同步、Linux工具链部署及可选图形应用支持。

如果您希望在Windows系统中获得接近原生Linux的开发体验,VSCode与WSL 2的组合可提供终端、文件系统、调试工具和扩展生态的高度协同。以下是实现该环境的关键配置步骤:
本文运行环境:Windows 11,WSL 2(Ubuntu 22.04),VSCode 1.90
一、安装并初始化WSL 2
WSL 2通过轻量级虚拟机运行完整Linux内核,相比WSL 1具备完整的系统调用兼容性和更高I/O性能。需确保Windows已启用虚拟化支持并完成核心组件部署。
1、以管理员身份打开PowerShell,执行:wsl --install
2、重启计算机后,系统自动下载并安装默认发行版(通常为Ubuntu)
3、首次启动时设置Linux用户名与密码,完成初始化
二、配置VSCode远程开发插件
Remote - WSL插件使VSCode能直接加载WSL中的文件系统、调用Linux命令行工具,并复用WSL内安装的编译器与语言服务器。
1、在VSCode扩展市场中搜索并安装Remote - WSL
2、关闭所有VSCode窗口,重新以WSL模式启动:点击左下角远程连接状态栏,选择Open Folder in WSL
3、浏览至WSL中的路径(如/home/username/project),确认VSCode窗口右下角显示WSL: Ubuntu
三、同步VSCode设置与扩展
VSCode支持跨平台同步用户设置、快捷键、代码片段及已安装扩展,避免在WSL环境中重复配置开发偏好。
1、登录VSCode账户,在设置中启用Settings Sync
2、在WSL窗口中点击齿轮图标 → Turn on Settings Sync
3、选择要同步的项目,确保Extensions和Settings处于勾选状态
四、配置Linux专用开发工具链
在WSL中独立安装适用于目标开发场景的工具,例如C/C++编译器、Python环境或Node.js,确保与Windows主机隔离且版本可控。
1、在WSL终端中运行:sudo apt update && sudo apt install build-essential python3-dev nodejs npm
2、为Python项目安装pipenv:pip3 install pipenv
3、验证GCC版本:gcc --version,确认输出显示Linux平台对应版本号
五、启用图形应用支持(可选)
WSL 2默认不支持GUI应用,但通过集成Windows 11内置的WSLg,可直接运行Linux桌面程序并共享剪贴板与音频。
1、确保Windows更新至Build 22000或更高版本
2、在WSL中安装图形库:sudo apt install gnome-terminal
3、直接在WSL终端中输入:gnome-terminal,验证窗口是否在Windows桌面中弹出










