GitHub Codespaces 怎样限制预构建环境的资源使用

如果 GitHub Codespaces 的预构建任务越来越频繁、区域副本过多，或者团队成员总是选到不合适的机器，应该把问题拆成两层处理：预构建页面负责控制“什么时候、在哪里、保留多少份”，devcontainer.json 的 hostRequirements 负责限制“至少要有多少 CPU、内存和存储”。

官方地址：https://docs.github.com/en/codespaces/prebuilding-your-codespaces/configuring-prebuilds

下面按仓库管理员的操作路径配置。文中的界面图是原创说明图，不是 GitHub 实际截图。

先分清预构建和机器规格

预构建是由 GitHub Actions 创建的开发环境模板，目的是缩短 Codespace 的创建时间。它会占用存储，且每个区域、每个保留版本都可能形成独立的存储副本。预构建配置页能调整分支、配置文件、更新触发方式、区域和历史版本，但它不是一个直接填写“预构建使用 8 核机器”的表单。

机器规格要在仓库的 devcontainer.json 中声明最低要求。创建 Codespace 时，低于要求的机器会从可选列表中排除；组织策略、仓库大小和区域仍可能进一步缩小可用范围。

先把预构建的生成范围收窄

打开仓库主页，按 Settings → Code, planning, and automation → Codespaces 进入设置。在 Prebuild configuration 区域点击 Set up prebuild，选择需要预构建的分支和对应的 devcontainer.json。

接着按这三个设置收缩成本：

1. 更新触发：默认的 Every push 最及时，但每次推送都可能触发更新。若依赖只在容器配置变化时需要重建，改选 On configuration change；若能接受延迟，使用 Scheduled。
2. 区域范围：勾选只在团队实际使用的区域提供预构建。默认覆盖所有可用区域时，每个区域都会产生存储成本。
3. Template history：设置保留的预构建版本数量。只需要当前版本时可设为 1；保留旧版本方便回退，但每个版本都会继续占用存储。

保存后，若配置中出现跨仓库访问授权，先确认权限边界再继续。这个页面解决的是生成频率和存储副本，不会代替下面的机器规格设置。

再限制 Codespaces 可用的机器规格

在仓库中打开 .devcontainer/devcontainer.json，把 hostRequirements 放在最外层 JSON 对象中。下面示例只保留最低硬件要求，JSON 本身不加入注释；字段含义放在代码块后解释。

{
  "name": "team-dev",
  "image": "mcr.microsoft.com/devcontainers/base:ubuntu",
  "hostRequirements": {
    "cpus": 8,
    "memory": "8gb",
    "storage": "32gb"
  }
}

cpus、memory 和 storage 可以单独设置，也可以组合设置。它们表达的是下限，不是“强制所有人使用某一个型号”。例如上面的配置会让低于 8 核、8GB 内存或 32GB 存储的机器不再满足仓库要求。

提交到实际启用预构建的分支后，创建 Codespace 时打开机器类型列表：

看到低配选项标记为 Below requirements，而符合要求的选项显示为可用，说明仓库配置已经参与筛选。若一个选项同时受组织策略限制，它也可能不会出现，这不是配置文件失效。

保存后怎样判断设置真正生效

创建新的 Codespace 时，从仓库的 Code → Codespaces → New with options 进入高级选项，检查分支、配置文件、区域和机器类型是否与预期一致。预构建可用时，机器类型旁通常会出现 Prebuild ready；创建过程中也可能看到 Prebuilt codespace found。这两个提示说明创建流程使用了预构建，但不表示机器规格一定是最高档。

若修改了触发频率、区域或保留版本，回到仓库的 Codespaces 设置查看该配置的状态；若更新失败，先看对应 GitHub Actions 工作流，再决定是否恢复旧配置。若机器列表仍过宽，检查提交是否落在正确分支，以及 hostRequirements 是否位于 JSON 顶层。

常见问题

hostRequirements 能否直接指定机器型号？

不能。它描述 CPU、内存和存储的最低要求，最终可选机器还受账户、组织策略和区域影响。

预构建越多，启动一定越快吗？

不一定。多区域、多版本会增加存储和更新成本；应优先覆盖真实使用区域，并把保留版本设为团队确实需要的数量。

为什么改了配置仍能看到旧的预构建？

预构建更新由触发规则决定，更新工作流可能仍在运行。先看配置对应的工作流状态，再确认新的分支和配置文件已经提交。