GitLab：如何在合并至master分支前修改文件

首先明确：GitLab自带的项目钩子（比如pre-receive、post-receive）或者合并请求钩子里，直接在合并过程中修改仓库文件的操作是受限的——因为这些钩子运行在GitLab服务器端，直接修改仓库文件可能破坏Git的一致性，而且GitLab的设计也不允许这类操作在钩子中直接执行。

不过你可以通过以下两种可行方案实现需求：

方案1：CI/CD流水线结合合并请求触发器 #

你可以在CI/CD流程中添加专门阶段，在测试通过后自动修改文件并提交到合并请求分支：

• 配置CI流水线，当合并请求指向master分支时触发
• 在测试阶段通过后，新增modify-and-commit阶段：
  • 运行你的修改脚本，比如./update-file.sh
  • 用Git命令提交变更：git add target-file && git commit -m "Auto-update file before merge"
  • 将变更推送到当前合并请求的分支（需确保CI Runner拥有仓库写入权限，比如使用项目部署令牌）

这种方式完全在GitLab CI生态内操作，变更会清晰展示在合并请求中，便于审核。

方案2：合并请求Web钩子触发外部脚本 #

如果需要更灵活的控制，可设置GitLab的合并请求Web钩子：

• 在项目设置中开启合并请求钩子，监听merge_request事件（比如当合并请求已批准且流水线成功时）
• 钩子触发外部服务/脚本，拉取当前合并请求分支，运行修改脚本，提交并推送变更回分支

注意：无论哪种方案，都要确保修改后的代码能通过后续CI检查，避免陷入流水线循环触发的问题。同时绝对不要直接在GitLab服务器的钩子中修改仓库文件，这类操作可能导致仓库状态不一致，甚至触发GitLab异常检测机制。

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