remote分支合并

### Git 中合并远程分支的最佳实践

#### 合并前准备
确保工作目录干净，没有任何未提交的更改。可以使用 `git status` 来检查当前状态。

$ git status

如果存在未提交的更改，则先处理这些更改再继续操作[^1]。

#### 获取最新变更
在执行任何合并之前，应该获取最新的远程仓库数据：

$ git fetch origin

这一步不会自动修改本地文件，只会更新远程跟踪分支的信息[^2]。

#### 创建新分支用于测试
为了安全起见，在进行实际合并不妨基于目标分支创建一个新的临时分支来进行测试：

$ git checkout -b test-merge origin/dev

这样可以在不影响现有工作的前提下验证合并的结果[^3]。

#### 执行合并
假设要将远程 `origin/main` 的变更加入到本地 `dev-libai` 分支中，有几种方式可以选择：

##### 方法一：直接拉取并覆盖
这种方式适合于希望完全替换掉本地分支的内容的情况：

$ git checkout dev-libai
$ git reset --hard origin/main

请注意此方法会丢失本地分支上的所有历史记录和更改。

##### 方法二：常规合并
这是最常用的方案之一，它会在保留两个分支各自的历史基础上完成合并过程：

$ git checkout dev-libai
$ git pull origin main

上述命令相当于先后运行了 `fetch` 和 `merge` 两步操作[^4]。

##### 方法三：Squash 后合并
当只需要引入特定范围内的提交而不改变原有结构时可采用这种方法：

$ git checkout dev-libai
$ git merge --squash origin/main
$ git commit -m "Merge changes from main into dev-libai"

通过 `--squash` 参数可以让合并后的结果看起来像是单次提交的效果。

#### 解决冲突
无论采取哪种方式进行合并都可能遇到冲突情况，此时需要手动编辑解决冲突部分后再标记为已解决，并最终完成整个流程中的最后一次提交动作。

#### 推送至远程
确认无误之后就可以把新的合并成果推送到对应的远程位置上了：

$ git push origin dev-libai

---