VSCode与WSL 2深度集成可提供接近原生Linux的开发体验，需依次完成WSL 2安装配置、Remote-WSL扩展启用、默认发行版及文件挂载设定、GPU与GUI支持开启，以及工作区持久化设置。
如果您希望在Windows系统上获得接近原生Linux的开发体验，VSCode与WSL 2的集成可提供高效、低延迟的编辑与运行环境。以下是实现二者深度协同的操作路径：
本文运行环境：Windows 11，WSL 2（Ubuntu 22.04），Visual Studio Code 1.86
一、安装并配置WSL 2基础环境
该步骤确保Linux子系统以最新架构运行，并为后续VSCode远程连接奠定兼容基础。
1、以管理员身份打开PowerShell，执行：wsl --install
2、重启计算机后，在终端中运行：wsl --set-default-version 2
3、从Microsoft Store安装Ubuntu 22.04，启动后完成初始用户设置。
二、安装VSCode并启用Remote-WSL扩展
VSCode通过官方Remote-WSL扩展直接识别WSL发行版，无需手动配置SSH或端口转发，实现无缝工作区挂载。
1、下载并安装Windows版VSCode（非Store版本）
2、启动VSCode，在扩展面板中搜索：Remote - WSL，点击安装
3、关闭所有VSCode窗口，重新以WSL上下文启动：code .（在已进入WSL终端后执行）
三、配置默认WSL发行版与文件系统访问
避免VSCode自动连接到非目标发行版（如Debian或Kali），同时确保Windows文件可通过/mnt/c稳定挂载。
1、列出已安装发行版：wsl -l -v
2、将Ubuntu 22.04设为默认：wsl --set-default Ubuntu-22.04
3、在WSL中验证挂载点：ls /mnt/c/Users，确认可读取Windows用户目录
四、启用WSL GPU加速与GUI应用支持
该配置允许在VSCode中直接调试CUDA程序或运行基于X11的Linux GUI工具（如gedit、gimp），提升开发完整性。
1、在Windows中安装WSLg（随Windows 11 22H2+自动启用），检查状态：wsl --status
2、在WSL中更新系统并安装图形依赖：sudo apt update && sudo apt install -y libgtk-3-0 libx11-xcb1
3、在VSCode中打开终端，确认DISPLAY变量已自动设置：echo $DISPLAY（应返回localhost:0）
五、配置VSCode工作区与自动同步设置
利用WSL文件系统作为主工作区，使VSCode设置、插件、快捷键等在WSL会话中持久化，且与Windows主机保持隔离又可按需互通。
1、在WSL中创建项目目录：mkdir -p ~/projects/myapp
2、在该目录下执行：code .，VSCode将加载WSL专属工作区
3、在VSCode设置中搜索remote.WSL.defaultExtensions，添加：["ms-python.python", "ms-vscode.cpptools"]
