vscode与 gitHub Codespaces 集成支持 浏览器 启动远程容器并本地编辑调试。步骤包括：一、安装 github Codespaces 扩展；二、从 GitHub 仓库直接启动 Codespace；三、用命令面板连接已有实例；四、配置 CLI 工具 管理生命周期。
如果您希望在本地开发环境与云端开发环境之间实现无缝协作，VSCode 与 GitHub Codespaces 的集成可让您直接在 浏览器 中启动远程开发容器，并通过本地 VSCode 客户端进行编辑、调试和版本控制。以下是完成该集成的具体步骤：
本文运行环境：macBook Pro，macOS Sequoia。
一、启用 GitHub Codespaces 扩展
VSCode 需通过官方扩展识别并连接 Codespaces 实例，该扩展提供远程容器配置、终端桥接及资源状态同步功能。
1、打开 VSCode，点击左侧活动栏中的扩展图标（或按快捷键 Ctrl+Shift+X）。
2、在搜索框中输入GitHub Codespaces，找到由 GitHub 官方发布的扩展。
3、点击“安装”按钮，等待扩展下载并自动启用。
二、从 GitHub 仓库直接启动 Codespace
该方式绕过手动配置，利用仓库根目录下的。devcontainer.json 自动拉起匹配的开发环境。
1、在 GitHub 网页端打开目标仓库页面。
2、点击绿色代码按钮旁的“Code”下拉箭头，选择 Open with Codespaces 选项。
3、在弹出面板中点击“Create codespace on main”，等待容器初始化完成。
4、当页面跳转至 VSCode for Web 界面后，点击左下角远程连接状态栏，选择Reopen in VS Code。
三、使用命令面板连接已有 Codespace
适用于已存在运行中 Codespace 实例的场景，可通过本地 VSCode 快速建立 ssh 隧道并挂载工作区。
1、确保已登录 GitHub 账户且个人访问令牌（PAT）具备 codespace:manage 权限。
2、在 VSCode 中按 Cmd+Shift+P（macos）调出命令面板。
3、输入并选择 Codespaces: Connect to Codespace 命令。
4、从列表中选择目标 Codespace，确认后 VSCode 将自动配置远程 SSH 连接并同步文件系统。
四、配置本地 VSCode 以支持 Codespaces CLI
通过 GitHub 官方 CLI工具 可在终端中管理 Codespaces 生命周期，本地 VSCode 终端可直连执行相关指令。
1、在终端中运行命令安装 GitHub CLI：brew install gh。
2、执行gh auth login，按提示完成 GitHub 账户认证。
3、在 VSCode 内置终端中输入gh codespace list，验证是否能获取当前用户所有 Codespace 实例。
4、如需新建实例，运行gh codespace create –repository owner/repo –branch main。
