VSCode连接WSL只需安装Remote - WSL扩展并确保WSL已运行；通过code .或命令面板启动，文件存于Linux路径，终端与工具调用原生WSL环境，开箱即用。
VSCode连接WSL非常简单，核心是安装官方扩展并确保WSL已正确配置。不需要手动配置SSH或复杂网络设置，微软已将整个流程深度集成。
前提：确认WSL环境就绪
在Windows终端中运行 wsl -l -v，确认至少有一个已安装且状态为 Running 的Linux发行版（如Ubuntu-22.04）。若未安装，可通过 Microsoft Store 安装，或用 wsl --install 一键部署。确保系统已更新至 Windows 10 2004 或更高版本（推荐 Windows 11）。
安装Remote - WSL扩展
打开VSCode，在扩展市场搜索 Remote - WSL（由Microsoft官方发布），点击安装。安装完成后无需重启，VSCode会自动识别已运行的WSL实例。
windows-shell
下载
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
- 首次使用时，按 Ctrl+Shift+P 打开命令面板，输入 WSL: New Window 即可启动一个直接运行在WSL环境中的VSCode窗口
- 也可以在WSL终端中进入项目目录，执行 code . —— VSCode会自动连接当前WSL发行版并打开该文件夹
文件与开发体验说明
在WSL中打开的项目，所有文件默认存储于Linux子系统路径下（如 /home/username/project），而非Windows的C:。这意味着：
- 终端、调试器、构建工具（gcc、make、npm等）全部调用的是WSL内的原生Linux版本
- Windows应用无法直接访问WSL内部文件（/home 等路径），但可通过 \wsl$ 在资源管理器中浏览（仅用于查看，不建议在此编辑）
- 推荐把代码放在WSL文件系统内，避免跨系统路径问题和权限异常
常见小问题处理
如果 code . 没反应，检查是否已安装VSCode Server：它会在首次运行时自动下载（需联网）。若失败，可手动在WSL中运行 curl -fsSL https://aka.ms/install-vscode-server | bash。
- 终端显示 bash: code: command not found？运行 code --install-server 再试
- 想切换到其他WSL发行版？命令面板输入 WSL: Switch Distribution
- 需要图形界面（如Electron调试）？启用WSLg（Windows 11自带）或配置X Server（Windows 10需额外安装）
基本上就这些。整个过程无需改配置、不碰端口、不启服务，VSCode + WSL组合已经做到开箱即用。
