VSCode远程隧道功能可绕过防火墙/NAT限制，通过GitHub身份验证将本地工作区加密暴露为临时远程端点；需启用tunnel服务、登录授权GitHub、创建命名隧道、跨平台访问，并支持管理活跃隧道。
如果您希望在任意网络环境下通过互联网安全地连接到本地 VSCode 开发环境，但无法直接访问该设备，则可能是由于防火墙限制、NAT 封闭或缺少公网 IP 地址。VSCode 的远程隧道功能可绕过这些限制，将本地工作区暴露为一个加密的、临时的、基于 GitHub 账户身份验证的远程端点。以下是启用并使用该功能的具体步骤：
本文运行环境：MacBook Air M2，macOS Sequoia。
一、启用远程隧道功能
远程隧道依赖 VSCode 桌面客户端内置的 tunnel 服务，需确保已登录 GitHub 账户并启用隧道权限。该功能默认关闭，必须手动激活。
1、启动 VSCode 桌面版，点击左下角齿轮图标，选择“设置”。
2、在设置搜索栏输入 remote.tunnels，找到 “Remote Tunnels: Enabled” 选项。
3、勾选该复选框，保存设置。
4、重启 VSCode，使隧道服务初始化。
二、登录 GitHub 账户并授权隧道服务
远程隧道使用 GitHub OAuth 进行身份绑定与访问控制，未登录或未授权将无法创建隧道端点。每次首次启用时均需完成此流程。
1、按下 Cmd+Shift+P（Mac）或 Ctrl+Shift+P（Windows/Linux），打开命令面板。
2、输入并选择 “Remote-Tunnels: Sign in to GitHub” 命令。
3、浏览器自动打开 GitHub 授权页面，点击 “Authorize VisualStudioCode” 完成授权。
4、返回 VSCode，状态栏右下角应显示 GitHub 用户头像及 “Tunnels Ready” 提示。
三、创建并共享远程隧道
创建隧道后，VSCode 会分配唯一 URL，该 URL 可被其他设备用于连接当前工作区。URL 有效期默认为 7 天，且仅对已授权的 GitHub 成员可见（若设置为私有）。
1、再次打开命令面板，输入并选择 “Remote-Tunnels: Create Tunnel”。
2、在弹出的输入框中为隧道指定一个唯一名称（如 my-python-project），不支持空格和特殊字符。
3、确认后，VSCode 在右下角通知栏显示隧道 URL，格式为 https://github.com/codespaces/t/your-github-username-my-python-project。
4、点击 URL 即可在浏览器中打开 Codespaces 界面，或复制链接发送给协作成员。
四、在另一台设备上连接该隧道
远程隧道支持跨平台访问，接收方无需安装 VSCode 桌面版，可通过网页端或桌面客户端接入同一工作区，所有编辑操作实时同步。
1、在目标设备（如 Windows 笔记本）浏览器中访问上一步生成的隧道 URL。
2、GitHub 自动验证登录状态；若未登录，跳转至 GitHub 登录页完成认证。
3、加载完成后，页面显示 VSCode Web 界面，左侧资源管理器中列出本地工作区全部文件。
4、点击任意文件即可编辑，保存操作直接写入原始设备的本地磁盘。
五、管理活跃隧道与关闭连接
每个隧道实例占用系统资源，长期闲置可能影响性能。VSCode 提供可视化管理界面，允许用户随时查看、重命名或终止运行中的隧道。
1、按下 Cmd+Shift+P，输入并选择 “Remote-Tunnels: Show Active Tunnels”。
2、弹出侧边面板，列出当前所有活跃隧道及其状态（Active / Expired）、创建时间与访问次数。
3、将鼠标悬停在某条隧道条目上，点击右侧出现的垃圾桶图标。
4、确认 “Stop Tunnel” 后，该隧道 URL 立即失效，所有已连接客户端断开并提示 “Connection lost”。
