Remote-Tunnels非远程桌面，其能力边界导致终端卡死、扩展不加载；需满足VS Code 1.82+、Microsoft账户登录、remote.tunnels.enabled启用三条件，且受网络策略、代理、WebSocket拦截及固有设计限制影响。
能连上，但连得不稳定、扩展不加载、终端卡死——这不是配置错了，是 Remote Tunnels 的能力边界被误当成“远程桌面”在用。
Remote-Tunnels 命令面板不出现？先确认这三件事
很多人输 Remote-Tunnels: Create Tunnel 没反应，根本不是插件没装，而是前置条件没满足：
-
VS Code必须是 1.82+ 桌面版（vscode.dev或移动端 App 无法创建隧道） - 左下角状态栏必须显示 Microsoft 账户头像（不是 GitHub 登录；已登录其他账户需先点齿轮 →「帐户」→「注销」再重登）
- 设置里
remote.tunnels.enabled必须手动勾选（默认关闭，不打开命令不会注册）
三项缺一，命令就不可见。重启 VS Code 无效？卸载重装官方安装包（code.visualstudio.com），别信第三方打包版。
code tunnel login 卡在 Opening browser… 怎么办
这是企业内网/校园网最常见问题：系统策略拦截了浏览器唤起或 tunnelrelay.io:443 出站连接。
- 改用
code tunnel login --cli，它会输出授权码，手动粘贴到https://microsoft.com/devicelogin - 检查环境变量：
echo $HTTP_PROXY和$HTTPS_PROXY，若存在，启动时加--proxy-server=http://your-proxy:port - 杀掉残留进程：
pkill -f "code-tunnel"，否则端口占用会导致后续启动失败
注意：code tunnel 默认不走系统代理，硬塞代理却没加参数，等于白配。
生成的 URL 打不开或卡在 Connecting…
这不是 VS Code 故障，而是网络链路或访问端配置问题：
- URL 必须是
https://vscode.dev/tunnel/xxx-yyy-zzz（当前主用），不是旧版github.com/codespaces/t/ - 访问设备浏览器必须已登录同一个 Microsoft 账户（Safari 默认禁用第三方 Cookie，换 Chrome/Edge 或临时关闭隐私设置）
- 本地开了 Clash/Surge/Proxyman 等代理？必须关闭——
code tunnel不走系统代理，强行转发必报WebSocket connection failed - 企业 Wi-Fi 或学校网络常拦截 WebSocket 流量（底层走
wss://），切手机热点验证是否为网络策略导致
链接本身 7 天过期，但只要 code tunnel 进程没被 kill、VS Code 没关机，连接可一直维持。
连上了，但终端打不开、扩展不加载、大文件卡顿
这是 Remote Tunnels 的固有设计限制，不是你配置漏了：
- 终端运行的是远端 shell，但 I/O 经 Web 层沙箱中转，
Ctrl+Shift+F全局搜索会明显变慢，git status大仓库响应延迟高属正常 - 扩展不自动加载：Remote Tunnels 不继承本地扩展，远程端需手动安装（且部分依赖本地二进制的扩展如 C/C++、Python 调试器可能失效）
- 调试断点不触发、终端历史不保留、未保存的编辑器标签页不恢复——这些运行时状态完全不共享，每次连接都是新会话
- 免费账户最多 4 个并发隧道，超限后旧隧道静默断开，错误提示为
Tunnel limit exceeded
真正容易被忽略的是：它不支持自定义域名、不能反向代理、无法集成公司 SSO。想绕过这些？就得换方案——比如 ssh -R 搭配 VPS，或者 frp 自建中继。
