01 它是干嘛的
Codespaces 把一个完整的开发环境（编辑器、运行时、依赖、数据库客户端）装进容器放在云上，从仓库一键启动。它针对的是「新人入职三天装不好环境」和「同事的机器上能跑、我的跑不起来」这两件长期折磨开发团队的事：环境不再由每个人各自拼装，而是跟着仓库走。
02 为什么会有它
「在我机器上是好的」这句话是怎么来的
一个项目要跑起来，需要一堆东西对得上：操作系统的版本、运行时的版本、几十个依赖包的版本、编译工具、本机环境变量、数据库连接……这些在每台电脑上都是各自手工攒起来的，攒法还不一样。
于是就有了那句经典台词「在我机器上是好的」。同一份代码，同事能跑你不能跑，问题不在代码，而在两台机器的环境已经悄悄长成了两个样子。新人入职更痛苦：花两三天装环境、跟版本冲突搏斗，第一周几乎写不了几行业务代码。
Codespaces 的做法是把环境写成配置（一个放在仓库里的容器描述文件），由平台按这份配置在云上创建开发环境。这样一来环境就和代码一起版本管理：配置改一次，所有人下次启动得到的都是同一个环境。换电脑、换系统、临时用别人的机器，登录后照样开工。
03 它怎么工作
你在仓库页面上启动一个工作区，平台按仓库里的容器配置在云上创建一台开发实例，把代码放进去、装好依赖，再把编辑器接到你浏览器里。
从点「启动」到能写代码，中间发生了什么
- 1① 读取仓库里的环境配置
平台先找仓库中的容器描述文件，确定这套环境该长什么样、预装哪些工具。
- 2② 在云上创建实例
按配置拉起一台开发容器，指定规格（几核几 G），并分配一个可访问的地址。
- 3③ 拉取代码并安装依赖
把对应分支的代码放进去，执行配置里写的安装命令；这一步可以缓存，下次启动更快。
- 4④ 注入密钥与环境变量
从账户里取回你保存的密钥，以环境变量形式注入，不用把它们写进代码。
- 5⑤ 连接编辑器
编辑器界面在浏览器里打开，也可以用本地编辑器远程连上去，体验和本地几乎一致。
- 6⑥ 停用与保留
不操作一段时间后自动停用以停止计费，磁盘内容保留，下次启动接着用。
04 谁在用它
第一天登进去就能改代码，把「装环境」从几天压缩到几分钟。
每个项目一个独立环境，依赖互不干扰，不用在本地来回切换版本。
改一行文档或一个小 bug，不必把整个仓库克隆到本地。
用平板或旧电脑也能开发，重活交给云上的机器。
发一个链接，对方点开就是一个配好依赖的完整环境，省掉所有前置说明。
05 怎么用
不需要懂容器：会用 Git 和编辑器就能上手，深入定制环境时才需要写配置。
- 01在仓库页面上点击创建云端开发环境，选择机器规格。
- 02等待环境构建完成，浏览器里会直接打开完整的编辑器界面。
- 03先跑一次项目的安装与启动命令，确认环境可用。
- 04把常用的依赖安装与初始化命令写进环境配置文件，下次启动自动执行。
- 05需要本机体验时，用桌面编辑器远程连接这个环境。
- 06用完及时关闭；把默认的自动停用时间调短，避免闲置计费。
{
"name": "项目开发环境",
"image": "mcr.microsoft.com/devcontainers/javascript-node:22",
"postCreateCommand": "npm ci",
"customizations": {
"vscode": {
"extensions": ["dbaeumer.vscode-eslint", "esbenp.prettier-vscode"]
}
},
"forwardPorts": [3000]
}避坑提示
- !机器规格别默认开最大：先在低配档开发，编译确实卡再往上调，账单差别很大。
- !自动停用时间要调短，忘记关掉的闲置环境是最常见的隐形支出。
- !密钥放账户里注入，不要为了图方便写进配置文件提交上仓库。
06 关键概念
- 开发容器
- 把开发环境（系统、运行时、工具、依赖）描述成一个可复现的容器配置。
- 工作区
- 一个正在运行的云端开发环境实例，包含你的代码、依赖与临时数据。
- 端口转发
- 把实例里跑的服务端口映射出来，让浏览器能直接访问。
- 自动停用
- 一段时间无操作后自动关机以停止计费，磁盘内容会保留。