功能定位：为什么CI总耗时值得被“并行”拆解
在HelloWorld Cloud Playground里，并行构建并不是简单的“多开容器”，而是把一次Push自动拆成编译、测试、镜像、部署四组任务，让它们在同一流水线的不同节点同时起跑。官方在2026.5版把默认并发上限从2调到4，但项目若未显式声明parallel策略，仍会被强制串行，导致8 vCPU配额白白闲置。经验性观察：当仓库日更>30次、单测>500条时，开启后CI总耗时普遍缩短40–60%，而日更低频项目收益<10%，反而增加调度开销。
三步开启并行构建：最短路径与平台差异
步骤1：在仓库根创建helloworld-ci.yml
桌面端与Web IDE路径一致：Explorer → 右键根目录 → New File。若使用离线PWA，需先Commit到本地Git，再联网Push触发。示例片段（已剔除实验性字段）：
jobs:
build:
strategy:
matrix:
shard: [1,2,3,4] # 把测试集拆4份
runs-on: hw-cloud-8c16g
parallel: 4 # 关键行，默认不填=1
步骤2：调整并发上限
进入Settings → CI → Concurrency，把Project Quota滑块拖到8（教育版上限为4，商业版可开12）。移动端需切到桌面视图才能看到滑块；若灰显，说明机构管理员在后台做了硬限制，需提交工单。
步骤3：加缓存，防止并行撞车
在同文件追加：
- uses: hw/cache@v3
with:
path: ~/.npm|~/.cargo|~/.pip # 多语言并列用|
key: ${{ runner.os }}-${{ hashFiles('**/lockfiles') }}
缓存命中时，每个shard可再省约30秒（经验性观察，具体视依赖体积而定）。
常见分支与回退方案
- A分支：绿色构建评分面板报NaN→ 按官方ticket HW-4821，在Settings → Build → Eco Analysis关闭LFS检测即可回退。
- B分支：并行导致数据库测试端口冲突→ 在services字段加
ports: ['5432:5432/tcp']，并用job.services.postgres.ports[0]动态获取，避免写死。 - C分支：构建通过但部署失败→ 并行镜像推送时，Registry可能触发rate limit。缓解：把deploy job独立出来，加
needs: [build]，让镜像层复用。
例外与取舍：什么时候不该开并行
警告
以下场景开启后，可能反而拖慢或产生额外成本：
- 单测<100条且依赖已全缓存，调度开销>真实运行时间；
- 项目含大量Git LFS大文件，2026.5版并行拉取会重复计费流量；
- 教育版账号共享4 vCPU配额，四人同时开并行，会把整班塞进排队池。
与第三方机器人协同的最小权限原则
若使用第三方归档机器人做产物备份，只需给它read权限，并在.gdpr-ignore里把临时测试数据路径写进去，避免欧盟节点因并行上传而触发GDPR阻断。
故障排查：并行失败时的定位漏斗
| 现象 | 最可能原因 | 验证动作 | 处置 |
|---|---|---|---|
| shard 3永远排队 | 机构配额被其他同学占满 | Settings → CI → Usage实时图 | 错峰或申请临时提额 |
| 缓存恢复报错“Key not found” | 矩阵变量拼写不一致 | 对比shard 1与3的key字符串 | 统一变量命名 |
| 绿色评分NaN | Git LFS文件被计入碳排 | 关闭Eco Analysis→评分恢复 | 等2026.6官方修复 |
适用/不适用场景清单
适用：日更>30次、单测>500条、多语言mono-repo、需要ESG绿色评分披露的企业仓库。
不适用：LFS大文件主导、教育版共享配额、需严格串行版本号的移动端发版流水线。
最佳实践检查表（可直接复用）
- 先把单测拆为“单元”“集成”两层，只有单元层开并行，集成层保持串行，降低数据库污染概率。
- 任何shard都加
timeout-minutes: 10，防止排队死锁耗尽月度配额。 - 在README给出☑️
[ ] Enable parallel复选框，让协作者一眼知道当前策略。 - 每月初用Settings → CI → Usage导出CSV，观察并行度与总耗时趋势，若发现“并发提高、耗时反增”，回退到串行并提交Issue。
FAQ：你必须知道的3个细节
教育版账号最多能开几个并行？
默认4个，但机构总池是40 vCPU，若同课堂50人同时Push，系统会按时间片轮转，体感仍是排队。
并行构建会增加碳排吗？
绿色构建面板会把并发导致的额外CPU折算成瓦时，若缓存命中率高，最终总碳排通常低于“串行+重复编译”。
可以只对PR开并行，Push到主分支用串行吗？
在yaml顶部加if: github.event_name == 'pull_request'即可；合并后走单线程，降低生产环境风险。
收尾：下一步行动建议
你已经拿到可复制的yaml模板、平台差异、回退与排查清单。现在就把parallel: 4推到自己的HelloWorld仓库，观察一周CI总耗时曲线；若缩短<20%且排队增加，说明项目粒度不适合，再关回串行即可——整个实验零成本，却能立刻验证收益。
