上游 · 理解本功能前需先掌握的（1）：
下游 · 依赖/承接本功能的（0）：
暂无下游（建议学完它再进阶）
前置依赖包含从属概念升级流程承接
边方向 = 学习顺序（A→B 表示先学 A 再学 B）
为什么需要它
心智模型
换电脑、装环境是最烦的事，每个人本地配置都不一样，容易出各种「在我电脑上能跑」的问题。Codespaces 把整个开发环境搬到云端，打开浏览器就是一个配好的 IDE，换任何设备都能接着写。
历史背景 · 它为什么诞生诞生于 2020
诞生本地开发环境配置是开发者最大的时间黑洞：不同项目依赖不同语言/版本/工具链，"在我机器上能跑"成为协作痛点，新成员入职环境搭建动辄数小时。GitHub瞄准"云上即开即用的开发环境"，2020-05-06发布Codespaces limited public beta。
演进从2020年beta的"浏览器内VS Code+容器环境"，演进为完整dev container规范生态（devcontainer.json描述环境即代码）、云开发机、与Copilot/Actions/GitHub Classroom深度集成，2021年GA后成为远程开发和教学标配。
历史教训
"本地环境配置地狱"是普遍且高价值的痛点，解法是让环境成为代码——devcontainer.json把环境配置版本化、可复现、可分享。与已有编辑器生态（VS Code）深度绑定让用户零学习成本迁移。
功能介绍
GitHub Codespaces 是 GitHub 提供的云端开发环境（"a secure, configurable, and dedicated development environment"——一个安全、可配置、专属的开发环境）。它基于开发容器（Dev Container）技术：你可以在仓库里放一个配置文件（通常是 .devcontainer/devcontainer.json），指定用什么语言、装什么依赖、跑什么命令，GitHub 就据此在云端自动搭建一个一模一样的开发环境。通过网页或 VS Code 打开后，你看到的就是一个在线代码编辑器（IDE），内置终端（Terminal）和源代码管理（Source Control）功能，可以直接 commit、push。你还可以为任何仓库的任意分支（Branch）一键创建专属环境，开发完关闭即可，不会污染本地。它省掉了「装环境」这一步，也让多人协作时环境完全一致。
核心术语
开发环境（Development Environment）开发容器（Dev Container）集成开发环境（Integrated Development Environment，IDE）源代码管理（Source Control）分支（Branch）
适用场景
- 当你换了新电脑、不想重新配置本地环境时
- 当你想在浏览器或平板等设备上随时继续写代码时
- 当你想为某个 PR 或分支单独开一个隔离的开发环境审查代码时
- 当团队希望所有人的开发环境保持一致、避免「本地能跑云端崩」时
怎么操作（网页 vs 命令行 双轨）
🖱️ 网页操作 (GitHub.com)
- 打开任意仓库，点击绿色的 Code 按钮，再点击 Codespaces 标签
- 点击 Create codespace on main，等待云端环境构建完成
- 构建完成后即进入在线编辑器，可直接编辑、运行和提交代码
⌨️ 命令行 (进阶)
`gh codespace create` # 为当前仓库创建一个 Codespace`gh codespace list` # 列出你所有的 Codespace`gh codespace code` # 用本地的 VS Code 连接到指定 Codespace
新手建议先从网页操作入手，熟悉概念后再尝试命令行。命令行是真实开发中更常用的方式。
与其他功能的关系
| 关系（前置依赖 / 包含从属 / 概念升级 / 流程承接） | 说明 |
|---|---|
| 概念升级创建仓库（Create Repository） | 为仓库创建云端开发环境在线开发 |
官方文档
小结
SUMMARY
GitHub Codespaces 把开发环境搬进云端，基于 dev container 一键创建、任意设备可续写、环境人人一致。下一步：点开仓库的 Code → Codespaces，创建一个属于你的云端开发环境。