<p>需安装Remote - WSL扩展并配置默认发行版与工具链路径，使VSCode在WSL中运行：启用WSL、安装扩展、用code .打开项目、设默认发行版为Ubuntu并升级至WSL 2、配置gcc和python3路径。</p>
如果您在Windows系统中安装了WSL，并希望在VSCode中直接编辑和运行Linux环境下的代码，则需要正确配置VSCode以识别并连接到WSL实例。以下是实现协同工作的具体步骤：
本文运行环境：Surface Laptop 5，Windows 11。
一、安装WSL和VSCode Remote - WSL扩展
VSCode需通过官方扩展与WSL建立深度集成，该扩展提供终端、调试器、文件系统挂载等原生支持。未安装此扩展时，VSCode仅能作为普通编辑器打开WSL路径下的文件，无法调用Linux工具链。
1、确保已启用WSL功能并安装至少一个Linux发行版（如Ubuntu）。
2、从Microsoft Store或wsl.exe命令行安装最新版WSL内核更新包。
3、启动VSCode，进入扩展市场，搜索Remote - WSL，点击安装并重启VSCode。
4、安装完成后，在VSCode左下角状态栏点击远程连接图标，选择Open in WSL，即可加载WSL工作区。
二、使用WSL专用窗口打开项目目录
该方法使VSCode完全运行于WSL环境中，所有扩展、终端、调试功能均基于Linux上下文执行，避免Windows与Linux路径、权限、工具链不一致导致的问题。
1、在Windows终端中切换至目标项目目录，例如：cd /home/user/myproject。
2、输入命令：code .，此时VSCode会自动检测到WSL环境并启动专用窗口。
3、确认窗口左下角显示WSL发行版名称（如Ubuntu），且终端默认为bash而非PowerShell。
三、手动配置WSL默认发行版与版本号
当系统中存在多个WSL发行版（如Ubuntu、Debian、Alpine）时，VSCode可能连接到非预期的实例，需明确指定默认发行版及WSL 2版本，确保环境一致性。
1、以管理员身份打开PowerShell，执行wsl -l -v查看当前发行版列表及版本状态。
2、执行wsl --set-default Ubuntu将Ubuntu设为默认发行版。
3、对非WSL 2的发行版升级：执行wsl --set-version Ubuntu 2。
4、重启WSL：执行wsl --shutdown后重新打开VSCode，确保连接生效。
四、在VSCode中配置Linux专用开发工具链
VSCode需识别WSL中的编译器、调试器、Python解释器等工具路径，否则无法完成构建、运行或断点调试。这些路径不同于Windows本地路径，必须显式指向WSL文件系统。
1、打开命令面板（Ctrl+Shift+P），输入并选择C/C++: Edit Configurations (UI)。
2、在Compiler path字段中填入：/usr/bin/gcc（或其他对应发行版路径）。
3、打开设置（Ctrl+,），搜索python.defaultInterpreterPath，点击编辑并在WSL终端中运行which python3获取路径，填入该值。
4、保存后，重新加载窗口，验证终端中gcc --version与python3 --version可正常执行。
