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。
