合并DEV/STAGE/MAIN分支时忽略指定配置文件的方案

一、用Git属性实现合并时保留目标分支配置 #

要让DEV→STAGE→MAIN的合并操作不覆盖各分支的独立配置文件，核心是通过Git的merge=ours策略指定配置文件的合并规则：

• 在仓库根目录创建.gitattributes文件，添加以下内容（以configs.json为例，多个配置文件可逐行添加）：

  configs.json merge=ours
  

• 将该文件推送到所有分支（DEV、STAGE、MAIN）。此后执行分支合并时，Git会自动保留目标分支的配置文件版本，完全忽略源分支的对应文件，从根本上避免配置被覆盖。

二、通过GitLab V4 API直接修改指定分支的配置文件 #

要实现直接修改某分支（如MAIN）的配置文件，无需走合并流程，可按以下步骤调用GitLab API：

1. 拉取目标分支的配置文件内容 #

使用GET请求获取指定分支的配置文件（以MAIN分支的configs.json为例）：

curl --header "PRIVATE-TOKEN: <你的GitLab访问令牌>" \
"https://gitlab.example.com/api/v4/projects/<项目ID>/repository/files/configs.json?ref=MAIN"

返回结果中的content字段为base64编码的文件内容，需解码后进行修改。

2. 修改后推送更新 #

将修改后的配置内容重新编码为base64，通过PUT请求推送到目标分支：

curl --request PUT \
--header "PRIVATE-TOKEN: <你的GitLab访问令牌>" \
--header "Content-Type: application/json" \
--data '{
  "branch": "MAIN",
  "content": "<修改后的base64编码内容>",
  "commit_message": "Update configs.json for MAIN environment",
  "author_email": "your-email@example.com",
  "author_name": "Your Name"
}' \
"https://gitlab.example.com/api/v4/projects/<项目ID>/repository/files/configs.json"

注意：替换命令中的<你的GitLab访问令牌>、<项目ID>、<修改后的base64编码内容>等占位符；访问令牌需具备api和write_repository权限。

三、关键注意事项 #

• 确保.gitattributes在所有分支都存在，否则合并策略仅在包含该文件的分支生效。
• 直接修改MAIN分支配置后，后续STAGE→MAIN合并时，由于merge=ours策略，MAIN的配置会被保留，不会被STAGE的配置覆盖，完全满足你示例中"MAIN启用功能、STAGE不启用"的需求。
• 如果有多个独立配置文件，只需在.gitattributes中为每个文件单独指定merge=ours规则即可。

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