GitHub Codespaces 是 GitHub 提供的云端 VS Code 开发环境，支持浏览器直连或本地 VS Code 连接，通过 devcontainer.json 自定义容器配置，并需注意权限授权与密钥安全。
GitHub Codespaces 是 GitHub 提供的云端开发环境，直接集成在 VS Code 中，无需本地配置复杂开发环境。你可以在浏览器里打开一个完整、预配置的 VS Code 界面，代码、终端、扩展、调试器一应俱全，所有计算和存储都在云端运行。
如何快速启动一个 Codespace
进入你的 GitHub 仓库页面，在代码浏览界面顶部点击绿色的 Code 按钮，切换到 Codespaces 标签页，点击 Create codespace on main（或指定分支）。几秒后，VS Code 界面就会在浏览器中加载完成。首次使用会自动创建一个默认配置（基于 Ubuntu 的容器），后续可自定义。
本地 VS Code 连接 Codespace（推荐方式）
安装 VS Code 桌面版后，通过官方扩展 GitHub Codespaces 可以无缝连接云端环境。打开 VS Code → 点击左侧活动栏的 GitHub 图标 → 登录 GitHub 账号 → 选择目标仓库和分支 → 点击 Create New Codespace。VS Code 会自动建立 SSH 连接，把远程环境当作本地工作区使用：文件资源管理器显示远程文件，终端运行在云端，调试器可直接附加进程。
自定义开发环境（devcontainer.json）
Codespaces 的核心是 devcontainer.json 配置文件，它定义了容器镜像、预装工具、端口转发、扩展推荐等。把它放在 .devcontainer/ 目录下，Codespaces 启动时会自动读取。例如：
- 指定基础镜像：
"image": "mcr.microsoft.com/vscode/devcontainers/python:3.11" - 自动安装扩展：
"customizations": { "vscode": { "extensions": ["ms-python.python"] } } - 转发本地不可见的 Web 服务端口：
"forwardPorts": [8000]，访问时自动弹出浏览器或提供链接
权限与安全注意事项
Codespaces 默认拥有对当前仓库的读写权限，但不会自动获得其他私有仓库或组织资源的访问权。如需访问其他仓库，需在 GitHub Settings → Applications → GitHub Codespaces 中手动授权。敏感密钥不要硬编码进代码或配置文件，应使用 Codespaces secrets 功能（在仓库 Settings → Codespaces → Secrets and variables → Actions 中设置），它们会安全注入容器环境变量。
基本上就这些。用好 Codespaces 不需要懂容器底层，但理解 devcontainer 和权限模型能帮你更稳、更高效地协作和交付。
