vscode连接wsl开发必须满足三个硬条件：wsl2实例正在运行、使用windows原生版vscode、项目路径位于wsl原生文件系统（如/home/username/project）；缺一不可，否则将出现连接卡顿、终端未切换或npm权限错误等问题。
VSCode 连接 WSL 开发，不是“装个插件点一下就通”，而是必须满足三个硬条件：WSL2 实例正在运行、VSCode 是 Windows 原生版（非 Store/Web 版）、项目路径在 WSL 原生文件系统内（/home/username/project），三者缺一不可；否则必然卡在“正在连接…”、终端仍是 PowerShell、或 npm install 报 ENOSPC / 权限错误。
WSL2 没运行，VSCode 就连不上
WSL 不是常驻服务，关机、休眠、甚至某些 Windows 更新后，状态会变成 Stopped。VSCode 的 Remote-WSL 插件完全依赖这个运行态——它连不到，就看不到 \wsl$，也打不开任何 WSL 路径。
- 先在 PowerShell 或 CMD 里执行
wsl -l -v，确认发行版状态是Running；如果显示Stopped，运行wsl -d Ubuntu（把Ubuntu换成你实际的发行版名）手动唤醒 - 不想每次手动启？关掉 Windows 的“快速启动”：
设置 → 电源 → 相关设置 → 选择电源按钮的功能 → 更改当前不可用的设置 → 取消勾选“启用快速启动” - 旧版 WSL2 内核可能不兼容新插件，运行
wsl --update或手动下载安装wsl_update_x64.msi
Remote-WSL 插件没反应，大概率 VSCode 版本不对
Remote-WSL 只支持 Windows 原生安装版 VSCode（VSCodeUserSetup-x64.exe 类型），Microsoft Store 下载的“打包版”和 Web 版根本调用不了 WSL 接口——插件装了也搜不到 WSL: New Window，命令面板里一片空白。
- 去官网
code.visualstudio.com下载VSCodeUserSetup-x64.exe（或 ARM64）重装，别信 Store 版“也能用”的说法 - 装完检查插件是否启用：打开 Extensions 面板，搜
Remote - WSL，右下角必须是Enable，不是Disabled - 插件更新滞后时，手动卸载再重装，自动更新经常失败
终端还是 PowerShell，不是 bash/zsh
Remote-WSL 连接成功 ≠ 终端自动切到 WSL。VSCode 默认终端继承宿主系统 Shell，哪怕你在 /home/user/myapp 里打开项目，新终端默认仍是 Windows PowerShell。
- 按
Ctrl+Shift+`打开终端后，点击右上角+旁的下拉箭头，手动选bash或zsh（取决于你 WSL 里设的默认 shell） - 想让这个选择对当前窗口生效：在 WSL 窗口里按
Ctrl+Shift+P，运行Terminal: Select Default Profile，再选 WSL 对应的 profile - 注意：这个设置只作用于当前窗口，重启或新开窗口仍需重新选；目前没有全局默认 WSL 终端的配置项
npm install 卡住、ENOSPC、热更新失效
根本原因是项目或 npm 缓存落在了 /mnt/c/ 路径下。NTFS 挂载层不支持 Linux 文件权限、符号链接受限、inotify 监听极不稳定——webpack/vite 热更新失灵、chmod 无效、git hooks 不触发，全由此而起。
- 项目必须放在 WSL 原生路径，例如
~/projects/myapp，**绝不要放/mnt/c/Users/xxx/或C:\src\** - 检查磁盘空间：
df -h，如果/使用率超 90%，运行wsl --shutdown后重启，或清理~/.npm和node_modules - 提速 npm：
npm config set cache ~/.npm-cache，确保缓存也在 Linux 文件系统内 - Git 提交日志中文乱码？编辑
/etc/wsl.conf加入[boot] command = "sudo /usr/bin/locale-gen en_US.UTF-8 zh_CN.UTF-8"，然后wsl --shutdown重启
真正接入 WSL 的唯一可靠方式，是在 WSL 终端里执行 code .——不是从 Windows 资源管理器右键打开，也不是在 Windows 版 VSCode 里手动选 /home/xxx 路径。只有这个入口，才能让所有工具链（调试器、Git、Shell）真正跑在 WSL 用户空间里。左下角出现绿色 WSL 图标、终端提示符变成 user@hostname:~$，才算到位。
