需配置VSCode与WSL集成:一、启用WSL功能并安装Linux发行版;二、安装VSCode及Remote-WSL扩展;三、在WSL终端执行code .启动;四、通过Ctrl+Shift+P选择Remote-WSL: New Window;五、用code --remote wsl+发行版路径手动指定环境。

如果您在Windows系统中安装了WSL,并希望使用VSCode直接在Linux环境中进行开发,则需要配置VSCode与WSL之间的集成连接。以下是完成该连接的具体步骤:
本文运行环境:Windows 11,WSL2(Ubuntu 22.04)
一、安装WSL并启用相关功能
确保Windows系统已启用适用于Linux的子系统功能,并成功安装至少一个Linux发行版。此步骤为VSCode连接WSL的前提基础。
1、以管理员身份打开PowerShell,执行命令:wsl --install。
2、重启计算机完成安装。
3、启动已安装的Linux发行版,完成初始用户设置。
二、安装VSCode并配置Remote-WSL扩展
VSCode需通过官方Remote-WSL扩展实现与WSL环境的无缝通信,该扩展提供完整的远程开发体验,包括文件浏览、终端集成和调试支持。
1、从官网下载并安装最新版VSCode(64位)。
2、启动VSCode,在扩展面板中搜索Remote - WSL。
3、点击“安装”按钮,等待扩展安装完成并自动启用。
三、通过命令行启动VSCode连接WSL
使用命令行方式可确保VSCode以WSL上下文启动,从而直接访问Linux文件系统和工具链。
1、在WSL终端中执行命令:code .。
2、若首次运行,VSCode将自动在WSL中下载并安装服务器组件。
3、安装完成后,当前窗口即切换为WSL工作区,资源管理器显示Linux路径,集成终端默认为bash或zsh。
四、从VSCode界面直接打开WSL文件系统
无需依赖命令行,可通过VSCode图形界面快速进入已安装的WSL发行版,适用于不熟悉终端操作的用户。
1、在VSCode中按下Ctrl+Shift+P打开命令面板。
2、输入并选择Remote-WSL: New Window。
3、在弹出的发行版列表中选择目标Linux发行版(如Ubuntu-22.04)。
4、新窗口启动后,状态栏左下角将显示WSL: Ubuntu-22.04标识。
五、手动指定WSL发行版并打开特定项目目录
当系统中存在多个WSL发行版时,可通过参数精确控制VSCode连接的目标环境及工作路径。
1、在Windows PowerShell或CMD中执行:code --remote wsl+Ubuntu-22.04 /home/username/project。
2、确认WSL中对应路径存在且有读写权限。
3、VSCode将直接打开该Linux路径,终端自动初始化为该发行版默认shell。










