GitLab合并冲突修复求助：分支冲突反复出现且内置工具无效

本地冲突修复的标准操作流程 #

• 拉取最新development分支到本地：

  git checkout development && git pull origin development
  

• 切换到任务分支：

  git checkout branchTaskNumber
  

• 将development合并到任务分支触发冲突：

  git merge development
  

• 手动解决冲突时的重点处理：
  • 空格/换行类冲突：打开编辑器的显示空白字符功能（比如VS Code开启「Render Whitespace」），严格遵循项目统一的缩进规则（如4空格/2空格，禁止tab与空格混用），对齐两边的空白格式
  • PHP数组键顺序冲突：按项目约定的数组键排序规则调整（比如字母序、业务逻辑序），也可以用PHP-CS-Fixer这类工具批量格式化数组结构，统一代码风格
• 冲突解决后提交并推送：

  git add .
  git commit -m "Fix merge conflicts with development"
  git push origin branchTaskNumber
  

修复后GitLab仍显示冲突的排查要点 #

• 确认本地提交已推送到远程：用git log对比本地与远程分支的提交哈希，确保修复后的代码已成功推送
• 刷新GitLab合并请求页面，或关闭后重新打开——部分场景下GitLab的缓存会导致冲突状态未更新
• 若GitLab在线Resolve conflicts按钮无效，放弃在线编辑，回到本地按上述标准流程处理：在线工具对格式类冲突的处理逻辑常不如本地编辑器精准

长期预防这类冲突的方案 #

• 配置.editorconfig文件：强制统一项目的缩进、换行符、空格规则，要求所有开发者IDE开启对应配置
• 引入代码格式化工具：PHP项目用PHP-CS-Fixer，在提交前自动格式化代码，从根源上避免空格、数组键顺序这类风格差异引发的冲突
• 定期同步分支：开发过程中每隔1-2天，将development分支合并到自己的任务分支，提前解决小冲突，避免积累成大规模冲突
• 启用GitLab分支保护规则：设置合并请求必须先与目标分支同步（即解决冲突后才可合并），从流程上减少冲突提交的可能

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