VSCode连接WSL卡在“Starting VS Code Server…”是vscode-server进程秒退所致，主因包括权限错误（如root属主）、残留.lock文件、shell初始化阻塞（如.zshrc中同步执行curl）、networkingMode非NAT、插件配置不同步（如.codex未复制）、端口绑定失败或代理设置无效。
VSCode连接WSL卡在“Starting VS Code Server…”
这基本不是网络超时，而是 vscode-server 进程在 WSL 里启动几秒内就崩溃退出了。日志通常为空或只有两行，ps aux | grep node 看不到任何 vscode-server 进程。
常见诱因包括：
-
~/.vscode-server目录权限被改成了root（比如误用sudo code .） - 残留的
.lock文件卡住初始化：ls -l ~/.vscode-server/bin/*/server.js.lock -
.zshrc或.bashrc里有阻塞命令（如未加&的curl、git config --global、command -v检查等），导致 shell 初始化超时，VS Code 主动 kill 掉 server - WSL 的
networkingMode不是NAT（例如设成了mirrored），DNS 解析失败或端口映射异常，server 启动时拉扩展/绑定本地端口直接报错退出
快速验证是否为 shell 阻塞：在 WSL 终端中执行 env SHELL=/bin/bash code .。如果能连上，问题就出在你的默认 shell 配置里。
Windows 和 WSL 之间插件配置不同步（如 Codex 登录失效）
VS Code 插件在 Windows 下登录后，Token 一般存在 C:\Users\[用户名]\.codex；但 Remote-WSL 模式下，插件会去 Linux 的 $HOME/.codex 找，而这个路径默认是空的——它不会提示你重新登录，而是静默失败，报错看起来像网络中断。
解决方法很简单：
- 确认 Windows 用户名（比如
JohnDoe）和 WSL 用户名（比如john） - 在 WSL 终端中运行：
cp -r /mnt/c/Users/JohnDoe/.codex /home/john/.codex - 确保目标目录权限正确：
chown -R john:john /home/john/.codex - 完全退出 VS Code（包括托盘进程），再重新打开
注意：.codex 是典型例子，其他依赖本地配置的插件（如 GitHub Copilot、Tabnine）也适用同一逻辑——它们不跨文件系统同步，得手动复制。
端口转发失败：localhost:3000 在 Windows 浏览器打不开
这不是 VS Code 的问题，是 WSL2 缺少必要 Linux capability 导致的。普通用户无法绑定 1–1023 端口（如 :80、:443），而部分开发服务（如 Next.js、Vite 默认 :3000）在 WSL 内监听后，Windows 侧无法反向访问，现象就是浏览器一直 pending 或 ERR_CONNECTION_REFUSED。
根本解法是给 WSL 的 init 进程注入 CAP_NET_BIND_SERVICE：
- 先确保已安装
libcap2-bin：wsl -d Ubuntu-22.04 -- sudo apt install -y libcap2-bin - 执行 capability 注入：
wsl -d Ubuntu-22.04 -- sudo setcap 'cap_net_bind_service+ep' /init - 重启 WSL：
wsl --shutdown，再打开 VS Code
该操作只对 WSL2 + Ubuntu 22.04 及更新版本有效；Ubuntu 18.04 不支持 /init 路径，需改用 /usr/lib/wsl/lib/wsl_init（但不推荐——GLIBC 版本太旧，vscode-server 二进制本身都跑不起来）。
代理设置全无效？别碰 VS Code 的 http.proxy 配置项
在 Remote-WSL 场景下，VS Code 主程序（Windows）的 http.proxy 设置对 WSL 里的插件完全不起作用。插件实际走的是 WSL 内部的网络栈，受 Linux 环境变量和系统级代理控制。
但直接在 .bashrc 里写 export https_proxy=... 也常失败——因为 VS Code 启动 vscode-server 时，并不 source 你的 shell 配置文件。
真正有效的做法只有两个：
- 在 WSL 中全局设置 systemd 用户级环境变量（推荐）：
mkdir -p ~/.config/environment.d && echo "https_proxy=http://172.x.x.x:7890" > ~/.config/environment.d/proxy.conf，然后wsl --shutdown生效 - 或者，临时启动时传参：
HTTPS_PROXY=http://172.x.x.x:7890 code .（注意大小写，HTTPS_PROXY优先级高于https_proxy）
绕过代理的请求（如访问 localhost 或 127.0.0.1）仍需检查 NO_PROXY 是否包含这些地址，否则可能被错误转发。
