Codespaces 怎样调整预构建环境

调整 GitHub Codespaces 已有预构建，入口在仓库的 Settings → Codespaces → Prebuild configuration。找到目标条目，打开右侧省略号菜单选择 Edit，修改需要的选项后点 Update。保存配置与构建完成是两件事，后续还应查看该配置对应的运行结果。

官方地址：https://github.com/；官方操作说明：https://docs.github.com/en/codespaces/prebuilding-your-codespaces/managing-prebuilds。下文以虚构仓库 sample-team/cloud-workbench 为场景，界面图片均为原创操作说明图，不是实际仓库截图；按钮名称采用官方英文文档用词，语言与界面更新可能影响显示。

调整前确认仓库、权限和配置对象

这次任务只调整已有预构建的设置，不处理正在运行的个人 codespace。预构建配置与仓库分支、开发容器配置文件有关，应先确定团队要维护哪一组组合。示例使用 main 分支与 .devcontainer/devcontainer.json，它们只是示意，不要求读者改成相同名字。

管理预构建需要仓库管理员权限，仓库还需具备使用相关功能的账号与组织条件，GitHub Actions 也需要启用。如果 Settings 或 Codespaces 入口不可见，先核对仓库权限、账号与组织功能条件；不要在个人编辑器设置里反复查找仓库级预构建入口。预构建可能消耗计算与存储资源，应结合组织已有预算决定更新频率和区域。

如果需要改变镜像、工具链或依赖本身，改动来源通常是目标分支中的开发容器文件，而不是网页上的触发频率。可以先合并相应配置修改，再按以下路径管理预构建；不要以为选择一个更新频率就会自动安装新的项目依赖。

步骤一：打开目标预构建并保存调整

1. 进入目标仓库主页，点击仓库顶部的 Settings。若标签收起，展开仓库导航菜单后选择 Settings。
2. 在左侧 Code, planning, and automation 分组内点击 Codespaces，找到 Prebuild configuration 区域。
3. 核对目标条目的分支与配置文件，点击右侧 … → Edit，在编辑页调整需要的触发方式或可用区域。
4. 检查修改范围后点击 Update。如果出现跨仓库访问授权页，先阅读所请求权限，再按实际需要处理。

保存后的可见状态应是页面没有阻断性的保存错误，目标配置仍对应预期分支与文件，所修改的选项能够在重新打开编辑页时读到。若页面要求授权或显示错误，应先处理它；没有出现保存错误不等于预构建运行已经成功。

对修改本身应有一个明确目标，例如“减少每次业务代码推送引发的更新”或“仅保留团队使用的区域”。不要一次同时更改分支、触发方式、区域和依赖，导致失败时无法判断是哪一项改变了行为。可编辑字段以当前页面为准，不能修改目标组合时应按组织流程管理对应配置。

步骤二：触发构建并查看对应运行结果

1. 回到同一仓库的 Settings → Codespaces，在目标预构建条目右侧打开 … 菜单。
2. 需要立即更新时，选择 Manually trigger。若保存动作已经产生新的运行，可以直接观察那一次运行，避免为了刷新状态重复触发。
3. 在目标条目点击 See output，进入对应 GitHub Actions 运行详情；查看本次运行是否仍在排队、执行中或已经结束。需要历史记录时，从条目菜单选择 View runs。

这一步的完成状态是找到目标配置的新运行，确认其运行结果成功，且详情与预期仓库、分支及配置相符。Currently running 只说明尚在执行；历史 Last run 文案也不足以证明刚刚的调整已经完成。若失败，应在这次运行详情里定位失败阶段，不要把另一分支的绿色记录当作本次结果。

预构建更新成功后，团队仍需在日常使用中以匹配配置创建新的 codespace 来体验环境变化。已经存在的个人 codespace 不会仅因修改了预构建设置就自动替换全部环境。本文未登录仓库、修改配置或实际触发构建，以上状态条件供读者完成操作时判断。

常见问题与最终确认

为什么编辑器里改了设置，预构建没有变化？

个人编辑器偏好与仓库开发容器配置属于不同层级。先确定需要的是编辑器体验变化、容器环境变化，还是预构建更新策略变化，再修改对应对象。

禁用运行后为什么仍可能使用旧预构建？

Disable runs 暂停后续更新，不等于删除已经生成的预构建。不要用这个操作代替修改环境或删除配置的流程。

只有定时更新，是否保证每个新依赖都已准备好？

不能。调度间隔、最近一次成功运行以及依赖改动位置都会影响结果。调整更新策略时应和团队接受的环境新鲜度一致。

完成时记录四项：目标仓库和配置组合、保存后的选项、对应新运行结果以及团队接下来使用的创建方式。保留这些信息比只记一句“已点 Update”更能避免交接误解。

参考资料：管理已有预构建 https://docs.github.com/en/codespaces/prebuilding-your-codespaces/managing-prebuilds；预构建选项说明 https://docs.github.com/en/codespaces/prebuilding-your-codespaces/configuring-prebuilds。