Git Stash 与 Pull 冲突解决技术记录

Git Stash 与 Pull 冲突解决技术记录

一、冲突解决核心概念

在使用 git stash apply 合并暂存修改与远程更新时，冲突的产生及相关概念需明确理解。

1. 冲突产生的根本原因
   当执行 git stash apply 时，Git 会尝试将暂存的本地修改应用到经 git pull 更新后的工作区。若满足以下两个条件，冲突将不可避免：

   • 暂存内容修改的文件与 git pull 所更新的文件为同一文件；
   • 两者的修改位置存在重叠（如相同行或相邻行）。

2. 关键概念定义（针对 git stash apply 场景）

   • ours（我方）：指当前工作目录的状态，即 git pull 后同步的远程最新状态；
   • theirs（他方）：指通过 git stash 暂存的本地修改内容。

二、冲突识别与解决操作

冲突发生后，需通过规范步骤识别并解决，确保代码合并的准确性。

1. 识别冲突文件
   执行 git status 命令查看工作区状态，冲突文件会以如下形式显示：

   Unmerged paths:
     (use "git add <file>..." to mark resolution)
           both modified: <冲突文件名>
   

   其中，both modified 明确标识该文件存在冲突。

2. 冲突文件结构解析
   冲突文件中会包含 Git 自动生成的标记，清晰区分不同版本的修改：

   <<<<<<< Updated upstream   # ours（远程更新内容）
   console.log("远程新增的代码");
   =======
   console.log("本地暂存的功能");
   >>>>>>> Stashed changes    # theirs（本地暂存内容）
   

   上述结构中，Updated upstream 与 Stashed changes 分别界定了远程更新和本地暂存的修改范围，======= 为两者的分隔线。

3. 三种冲突解决方案

   • 方案1：保留远程修改（丢弃暂存内容）
     若确认远程更新更优先，可直接采用 git pull 后的版本：

     git checkout --ours <冲突文件>  # 应用远程更新版本
     git add <冲突文件>              # 标记为已解决
     

   • 方案2：保留暂存修改（丢弃远程变更）
     若本地暂存的修改更符合需求，可覆盖远程更新：

     git checkout --theirs <冲突文件>  # 应用本地暂存版本
     git add <冲突文件>                # 标记为已解决
     

   • 方案3：手动合并（推荐）
     当需要结合双方修改时，手动编辑冲突文件，整合有效内容。例如：

     <<<<<<< Updated upstream
     const api = new RemoteAPI();  # 远程修改
     =======
     const api = new LocalAPI();   # 本地暂存修改
     >>>>>>> Stashed changes
     

     手动合并为：

     const api = new HybridAPI();  # 融合双方逻辑
     

     完成后标记为已解决：

     git add <冲突文件>
     

4. 冲突解决后的后续操作
   所有冲突文件处理完毕后，需提交合并结果以完成整个流程：

   git commit -m "Resolve conflicts between stash and remote updates"
   

三、总结

在 git stash 与 git pull 结合使用的场景中，冲突的本质是本地暂存修改与远程更新的内容竞争。通过明确 ours 与 theirs 的定义，结合状态检查、结构分析和针对性解决方案，可高效处理冲突，确保代码库的一致性与完整性。手动合并方案虽需更多操作，但能最大限度保留双方有效修改，是复杂场景下的首选方式。