WSL2 必须运行且设为版本2，Remote-WSL插件是唯一入口，代码须放/home/username/project，工具链和扩展必须装在WSL内，否则调试、热更新等功能失效。
确认 WSL2 是否真正就绪
VSCode 连不上 WSL，90% 的问题出在底层没跑起来，不是插件或设置的问题。别急着装插件，先看 wsl -l -v 输出里你的发行版是不是 Running 状态。如果显示 Stopped，直接运行 wsl --shutdown 再 wsl 就能唤醒；如果报错 WSL2 is not supported，说明虚拟机平台没开，得用管理员 PowerShell 跑：dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart，然后重启电脑。
另外注意：WSL1 不支持 VSCode 的调试器挂载、文件监听（inotify），webpack 或 vite 热更新会失效。务必升级：wsl --set-version Ubuntu 2（把 Ubuntu 换成你实际的发行版名）。
Remote-WSL 插件必须装，且只能通过它进 WSL
这个插件不是“增强功能”，是唯一合法入口。装完之后，**不要**点 File → Open Folder 去选 C:\src\myapp —— 那样还是 Windows 环境，所有命令、路径、权限都错位。正确做法只有两个：
- 在 WSL 终端里
cd ~/myproject，然后输入code . - 或者在 VSCode 里按
Ctrl+Shift+P，搜WSL: New Window，选发行版后手动浏览到/home/username/myproject
首次打开时，VSCode 会在 WSL 里自动部署 ~/.vscode-server，需要联网下载。如果卡住，检查代理设置或换源（比如清华镜像）。
项目路径必须放在 WSL 文件系统内
千万别把代码长期放在 /mnt/c/Users/xxx/... 下开发。NTFS 挂载不支持 chmod、符号链接行为异常、inotify 监听极不稳定——你会遇到 Git 权限报错、npm install 失败、热更新不触发等一堆“玄学问题”。
开发目录请固定在：/home/username/project。所有工具链（nodejs、python3、gcc）也必须在 WSL 里用 apt 或 pyenv 安装，Windows 主机装的完全不可见。
Git 配置、SSH 密钥、环境变量，全部以 WSL 用户的 ~/.gitconfig 和 ~/.ssh/id_rsa 为准，不会和 Windows 同步。
C/C++ 或 Python 扩展要“装到 WSL”里
在 VSCode 扩展面板搜 C/C++ 或 Python，安装后别漏掉关键一步：点击扩展右下角的 Install in WSL 按钮。否则插件只装在 Windows 端，无法调用 WSL 里的 gdb、clangd 或 pylint。
验证是否生效：按 Ctrl+` 打开终端，路径应是 /home/username/...；运行 which g++ 或 python3 --version，输出必须来自 WSL 环境而非 Windows。
调试时，断点和变量查看依赖 WSL 中的 gdb 或 debugpy，如果没装对位置，VSCode 会静默失败，连错误提示都不给。
最常被忽略的是：跨文件系统访问（比如从 WSL 里读 /mnt/c 的配置）看似方便，实则破坏整个工具链一致性。路径、权限、性能三者全崩，修起来比重装还费时间。
