Git分支合并终极指南：如何将dev分支的改动安全合并到main

## 问题背景 在现代软件开发流程中，我们通常会在一个独立的 `dev` 或功能分支上进行新功能的开发和 bug 修复，以保持 `main` 分支的稳定和可发布状态。当开发工作完成后，一个核心问题随之而来：如何将 `dev` 分支上的所有提交（commits）安全、正确地合并回 `main` 分支？ 本文将为你提供两种主流的解决方案：直接本地合并和通过 Pull Request (PR) 进行合并。 --- ## 方法一：使用 `git merge` 直接合并 这是最直接、最基础的方法，适合个人项目或简单的开发流程。整个过程可以分为以下几个步骤： ### 步骤 1: 切换并更新 `main` 分支 在进行任何合并操作之前，务必确保你的本地 `main` 分支是最新的，这可以有效避免不必要的合并冲突。 ```bash # 1. 切换到 main 分支 # git checkout main 也是一个等效的命令 git switch main # 2. 从远程仓库（通常是 origin）拉取最新的 main 分支内容 git pull origin main ``` ### 步骤 2: 执行合并 在确保 `main` 分支为最新状态后，执行 `git merge` 命令，将 `dev` 分支的提交历史合并进来。 ```bash # 将 dev 分支的提交合并到当前所在的 main 分支 git merge dev ``` * **无冲突情况**：如果 `main` 分支在 `dev` 分支创建后没有新的提交，Git 会执行一次“快进式合并”（Fast-forward）。如果 `main` 分支也有新的提交，Git 会自动创建一个新的合并提交（Merge Commit）。 * **出现冲突**：如果 Git 无法自动合并文件（例如，同一个文件的同一行在两个分支中都被修改了），它会提示合并冲突（Merge Conflicts）。你需要手动解决这些冲突。 ### 步骤 3: （如果需要）解决合并冲突 当冲突发生时，打开提示有冲突的文件，你会看到类似以下的标记： ```plaintext <<<<<<< HEAD 这是 main 分支中的内容 ======= 这是 dev 分支中的内容 >>>>>>> dev ``` 你需要编辑文件，手动决定最终要保留的内容，并移除 `<<<<<<<`, `=======`, `>>>>>>>` 这些标记。解决所有冲突后，执行以下命令完成合并： ```bash # 1. 将手动解决冲突后的文件添加到暂存区 git add . # 2. 提交合并结果，Git 会自动生成一个合并提交信息 git commit ``` ### 步骤 4: 推送变更到远程仓库 本地合并成功后，将更新后的 `main` 分支推送到远程仓库，例如托管在 `wiki.lib00.com` 上的项目。 ```bash # 将本地的 main 分支推送到名为 origin 的远程仓库 git push origin main ``` --- ## 方法二：团队协作的最佳实践 —— Pull Request (PR) 在团队协作中，直接向 `main` 分支推送代码通常是不被鼓励的。更规范、更安全的方式是使用 Pull Request（在 GitHub/Gitee 中）或 Merge Request（在 GitLab 中）。这种方法提供了代码审查（Code Review）的机会，并能集成自动化测试，从而保证代码质量。 流程如下： 1. **推送 `dev` 分支**：将你的本地 `dev` 分支推送到远程仓库。 ```bash # 确保你的 dev 分支是最新的 git push origin dev ``` 2. **创建 Pull Request**：在代码托管平台（如 GitHub）上，从 `dev` 分支向 `main` 分支发起一个 Pull Request。 3. **代码审查与讨论**：团队成员可以在 PR 页面审查你的代码，提出修改建议。你可以根据反馈继续在 `dev` 分支上提交新的修改，这些修改会自动同步到 PR 中。 4. **合并 PR**：一旦代码审查通过，并且所有自动化检查（如 CI/CD 流水线）都成功运行，拥有权限的维护者就可以点击页面上的 “Merge” 按钮。平台会自动完成合并操作，并将 `dev` 分支的改动应用到 `main` 分支。 --- ## 总结 * 对于**个人项目**，`git merge` 是一个快速高效的选择。 * 对于**团队项目**，强烈推荐使用 **Pull Request (PR)** 流程。它通过代码审查和自动化检查，极大地提升了代码质量和团队协作的透明度。 掌握这两种方法，你就能自如地应对各种分支合并场景。本指南由 **DP@lib00** 整理，希望对你有所帮助。