Remote-Tunnels可绕过无公网IP限制，但必须满足三个硬性条件：远端安装VS Code桌面版（1.82+）、使用Microsoft账户登录、且能联网——缺一不可；否则命令不出现、隧道无法启动或连接卡在Connecting…。
Remote-Tunnels 能绕过无公网 IP 限制，但必须满足三个硬性条件：远端装了 VS Code 桌面版（1.82+）、已用 Microsoft 账户登录、且能联网——缺一不可。
远端机器没反应？先确认这三件事
很多人点 Remote-Tunnels: Create Tunnel 没反应，不是插件没装，而是远端根本没就绪：
- VS Code 必须是桌面版（
code.visualstudio.com下载），vscode.dev或移动端 App 无法创建隧道 - 左下角状态栏必须显示头像 + “Tunnel Ready”，不是只显示头像；若显示“未登录”，要点击后选“使用 Microsoft 账户登录”（Outlook/Hotmail 邮箱注册的账号），GitHub 登录无效
- 首次启用会弹系统级权限请求（macOS 要允许辅助功能，Windows 可能卡在防火墙），拒绝后会出现
Failed to start tunnel server: permission denied，必须重启 VS Code 并重试授权
命令面板找不到 Remote-Tunnels 命令？检查设置开关
这不是插件问题，而是功能被默认关闭：
- 打开设置（
Cmd+,或Ctrl+,），搜索remote.tunnels.enabled，确保勾选 - 必须执行过
Remote-Tunnels: Sign in to Microsoft（不能只靠左下角头像“碰运气”登录） - 如果仍不出现命令，尝试重启 VS Code；某些旧版本（如 1.81）即使界面显示 1.82，也可能因更新不完整导致模块缺失，建议卸载后从官网重装
URL 打不开或卡在 Connecting…？不是 VS Code 的错
这是网络链路或访问端配置问题，和远端无关：
- URL 格式必须是
https://vscode.dev/tunnel/xxx-yyy-zzz（当前主用），不是github.com/codespaces/t/（旧版已停用），复制时注意别带空格或换行 - 必须用浏览器打开该链接，且浏览器已登录同一个 Microsoft 账户；Safari 默认禁用第三方 Cookie，会导致验证中断，换 Chrome / Edge 或临时关闭隐私设置
- 企业内网、学校 Wi-Fi 常拦截 WebSocket 流量（隧道底层走
wss://），切手机热点试试；本地开了 Clash/Surge/Proxyman 等代理必须关闭——code tunnel不走系统代理，强行转发必报WebSocket connection failed
连上了但终端打不开、扩展不加载？这是设计边界
Remote-Tunnels 的能力有明确限制，不是配置错误：
- 终端运行的是远端 shell，但 I/O 经 Web 层沙箱中转，所以
Ctrl+Shift+F全局搜索等快捷键可能失效或延迟明显 - 扩展加载依赖远端网络，若远端机器本身无外网，部分扩展（如 Python、Pylance）无法自动安装，需提前手动部署
- 工作区上下文只共享「当前打开的文件夹」，不是整个系统；虚拟机重启后隧道进程通常退出，得回到远端重新执行
Remote-Tunnels: Create Tunnel - 权限模型是账户级绑定，不是链接级：你生成的 URL 本身无访问控制，能否打开完全取决于对方是否登录了同一个 Microsoft 账户
最常被忽略的一点：Remote-Tunnels 不传密钥、不暴露端口、也不依赖 SSH，但它对远端机器的登录状态和网络连通性极其敏感——一旦 Microsoft 账户登出或网络中断，隧道就断，且不会自动重连。
