必须从WSL终端执行code .启动VS Code，确保后端进程运行于Linux内核；项目须存于/home/xxx而非/mnt/c/xxx，且需安装并启用官方Remote-WSL插件（ID：ms-vscode-remote.remote-wsl），左下角显示“WSL: Ubuntu”才表示连接成功。
在Windows上用VS Code通过Remote-WSL插件直接连接WSL2环境写代码，必须让VS Code后端进程真正在Linux内核中运行，而不是映射/mnt/c路径假装连上——否则调试器加载失败、符号表丢失、执行权限被拒，所有Linux工具链都形同虚设。
确认WSL2已就绪并启动
打开PowerShell（无需管理员权限），执行：wsl -l -v。确保发行版状态为Running且版本号是2；若显示Stopped，运行wsl -d Ubuntu（将Ubuntu替换为你实际的发行版名）手动唤醒。
这一步跳过会导致后续code .命令报错“WSL distribution not found”，不是插件问题，是子系统根本没活过来。
别信Windows资源管理器里双击文件夹打开的VS Code——它永远走Windows路径，左下角绝不会出现WSL标识。
装对插件：只装Remote - WSL，不碰SSH
在Windows版VS Code中按Ctrl+Shift+X打开扩展面板，搜索Remote - WSL，认准ID为ms-vscode-remote.remote-wsl的Microsoft官方出品插件，点击安装。
【卸载所有标着“WSL SSH”“Remote SSH for WSL”的第三方插件】——它们会劫持远程连接逻辑，覆盖官方Unix socket通信通道，导致code命令静默失败。
装完不用重启VS Code，但必须手动启用：在扩展列表里找到该插件，点击右下角Enable按钮。很多人卡在这一步，以为装完就自动激活了，其实不点Enable，命令面板里搜“WSL”什么都不会出来。
用对方式启动：必须从WSL终端敲code .
第一步：打开WSL终端（比如Ubuntu），cd到你的项目目录，例如cd /home/yourname/myproject。
第二步：执行code .。这是唯一正确起点——VS Code会自动下载VS Code Server到~/.vscode-server，并在Windows端拉起UI窗口。
让 Windows 桌面程序在开机时静默自启并隐藏到系统托盘。特别适用于 Flutter、Electron 等无视 VBS/ProcessStartInfo 窗口样式、难以隐藏的顽固应用。提供「VBS 启动器 + Python ctypes/Win32 API」的隐藏窗口方案，可稳定把窗口收进托盘且不闪控制台。
第三步：观察左下角状态栏。如果显示WSL: Ubuntu（或你实际发行版名），说明连接成功；若显示Windows或压根没标识，立刻关闭所有VS Code窗口，回到上一步重试。
注意：项目必须放在/home/xxx下，/mnt/c/xxx路径里的文件即使能编辑，gdb也读不到debug_info，编译时加-g也没用，这是WSL内核挂载策略硬限制，不是权限问题。
装好扩展并验证是否生效
方法一：打开命令面板（Ctrl+Shift+P），输入Remote-WSL: Show Log。如果返回日志内容，说明插件已加载；若提示“command not found”，证明没启用或被干扰插件屏蔽。
方法二：在Remote-WSL窗口中打开扩展面板，顶部会明确显示Extensions for WSL: Ubuntu。此时搜索Python，看到Install on WSL: Ubuntu按钮才代表可装；若只看到灰色的Install，说明该扩展不支持远程模式。
Python调试前务必在WSL中执行python3 -m pip install debugpy，否则F5直接报错“无法启动调试会话”。
调试C/C++：gdb和路径全得按Linux来
1. 在WSL终端中运行：sudo apt update && sudo apt install -y build-essential gdb。Windows里装的gdb完全无效，VS Code调试器调用的是WSL环境里的二进制。
2. 创建.vscode/launch.json，program字段必须写WSL路径，例如"program": "/home/yourname/myapp/build/app"；【C:\work\app这类Windows路径在这里会直接导致调试器启动失败】。
3. launch.json中设置"externalConsole": false，否则调试时弹出独立终端，所有输入输出都无法被捕获，断点命中后程序就卡死。
