蓝图开发中何时执行update-snapshot？GitLab流水线配置疑问

核心结论 #

• 提交（合并到master|main分支前）必须手动更新快照
• GitLab流水线中不需要调用npm run update-snapshots

详细说明 #

1. 快照测试的本质
   快照测试（源自Mocha、Jest等前端测试框架）通过对比代码生成的输出（如项目结构、配置文件）与预先保存的"快照"文件，验证变更是否意外修改了预期结果。对于JHipster蓝图而言，快照主要用于校验生成的项目代码是否符合设计预期。

2. 提交前手动更新快照的必要性
   当修改蓝图的生成逻辑导致输出内容变化时，现有快照会与新输出不匹配，测试直接失败。此时需要开发者在本地运行npm run update-snapshots生成新快照，并将更新后的快照文件一并提交——快照是测试的基准，必须和代码变更同步，否则后续流水线的测试环节会持续失败。

3. 流水线无需配置快照更新的原因
   流水线的核心作用是验证提交的代码与快照是否匹配，而非修改快照基准。如果流水线自动更新快照，会引发两个问题：

   • 快照文件在流水线中被修改，但无法自动提交回仓库，后续测试依然会失败
   • 掩盖代码变更带来的非预期输出，完全失去快照测试的校验意义
     你观察到JHipster Native等蓝图未在GitHub Actions中配置快照更新，正是遵循这个原则：流水线只做一致性校验，不修改基准文件。

4. JHipster蓝图快照实践补充
   JHipster社区的快照实践确实源自前端测试框架，虽然官方文档提及较少，但核心逻辑和前端快照测试一致：快照是代码变更的一部分，必须由开发者在本地验证后主动提交，流水线仅负责校验一致性。

内容的提问来源于stack exchange，提问作者javafueled