Remote-Tunnels 连接失败主因是移动端未安装或未更新官方 VSCode App（需 v1.90+），且需用 Safari/Chrome 打开链接并授权网络访问；主机端需配置 code tunnel 命令路径或通过命令面板获取 URI；运行时环境、扩展及网络质量均影响体验。
Remote-Tunnels 连接失败：vscode://vscode-remote/ 链接打不开
移动端点击链接后跳转 VSCode 失败，多数是因为设备没装官方 VSCode 客户端，或装了但不是最新版。iOS 和 Android 对 vscode:// 协议支持不稳定，尤其 iOS 17+ 后部分浏览器（如 Chrome）会拦截该协议跳转。
- 必须用官方 VSCode for iOS / Android（App Store 或 Google Play 下载），第三方“VS Code”应用无效
- 确保 VSCode App 已更新到 v1.90+（旧版不支持 Remote-Tunnels 的完整流程）
- 不要在微信、钉钉等内置浏览器里点链接——它们一律禁用自定义协议；改用 Safari（iOS）或 Chrome（Android）并允许“打开其他应用”提示
- 首次连接时，VSCode App 会弹出“允许访问本地网络”，必须点“允许”，否则隧道无法建立
Windows/macOS 主机上 code tunnel 命令报错：command not found
code tunnel 是 Remote-Tunnels 的 CLI 入口，但它不会随 VSCode 自动加入系统 PATH，尤其 macOS 安装方式不同（.zip 解压版 vs .pkg 安装版）或 Windows 用户未勾选“Add to PATH”选项时，终端根本找不到命令。
- macOS：运行
sudo /Applications/Visual\ Studio\ Code.app/Contents/Resources/app/bin/code tunnel（路径需确认是否为实际安装位置） - Windows：找到 VSCode 安装目录下的
bin\code.cmd，然后执行bin\code.cmd tunnel（常见路径如C:\Users\{user}\AppData\Local\Programs\Microsoft VS Code\） - 更稳妥的方式是先在 VSCode 窗口内按
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Remote-Tunnels: Show Connection URI，直接复制生成的链接，避免 CLI 依赖
平板连上后无法运行 Python/Node.js：缺少本地运行时环境
Remote-Tunnels 本质是把本地 VSCode 界面“投射”到移动端，所有代码仍在主机上执行。平板本身不运行解释器或 Node.js，所以 python、node 命令报错，不是连接问题，而是主机环境没配好。
- 检查主机是否已安装对应运行时：在主机终端运行
python --version或node --version，必须返回有效版本号 - VSCode 默认使用系统 PATH 中的解释器，如果主机用 pyenv/nvm 管理多版本，需在 VSCode 设置中显式指定路径（如
python.defaultInterpreterPath指向~/.pyenv/shims/python） - 注意：Remote-Tunnels 不支持主机上未安装的扩展功能（比如 Pylance、ESLint），这些仍需在主机 VSCode 中启用并配置
连接成功但编辑卡顿、终端响应慢
Remote-Tunnels 依赖主机网络出口质量，尤其当主机处于校园网、企业防火墙或 NAT 深层穿透环境下，隧道延迟高、带宽受限，导致编辑器光标滞后、终端回显延迟明显。
- 优先让主机直连公网宽带（避开路由器级 QoS 或运营商 NAT64）；若用 Wi-Fi，确保信号强度 > -65dBm
- 关闭主机上非必要后台程序（尤其是同步工具如 OneDrive、iCloud Drive，它们会争抢磁盘 I/O 和网络）
- VSCode 设置中降低负载：禁用
editor.quickSuggestions、关闭files.autoSave、限制终端历史行数（terminal.integrated.historyLimit设为 100） - 别在隧道里开大文件（>5MB）或启动 Webpack dev server —— 这些操作全在主机跑，但 UI 渲染和输入事件要跨网络往返，体验会断崖下降
