详细介绍：Git分支合并实战指南：从feature到master，一文搞定全流程！

摘要：你是否在合并Git分支时遇到过冲突、推送失败或历史混乱？本文手把手带你完成从功能分支（如 feature/webaudioapi）合并到 master 分支的完整流程，涵盖拉取、合并、解决冲突、推送等关键步骤，适合开发者日常协作使用，助你轻松驾驭Git合并操作！

在团队协作开发中，Git 分支管理是不可或缺的一环。我们通常在独立的功能分支上开发新特性，完成后将其合并回主分支（如 master 或 main）。然而，看似简单的“合并”操作，若处理不当，可能导致代码丢失、冲突频发甚至线上事故。

本文以实际项目为例，详细记录将 feature/webaudioapi 分支合并到 master 并推送到远程 GitHub 仓库的标准操作流程，无论你是 Git 新手还是想巩固基础的老手，都能从中获益。

✅ 前提条件

在开始之前，请确保满足以下条件：

已安装 Git 并配置好用户名和邮箱：

git config --global user.name "YourName"
git config --global user.email "your@email.com"

本地仓库已关联远程 GitHub 仓库（可通过 git remote -v 验证）
功能分支（如 feature/webaudioapi）已完成开发并通过测试

完整操作流程

步骤1：检查当前状态

进入项目目录，确认当前分支和工作区状态：

cd /home/projects/aws_polly
# 查看当前所在分支
git branch
# 查看文件修改状态
git status

确保你当前处于功能分支（如 feature/webaudioapi），且无未提交的更改。

步骤2：切换到 master 分支

要将功能合并进 master，必须先切换到目标分支：

git checkout master

提示：如果你使用的是较新版本的 Git，也可以使用更现代的命令 git switch master

步骤3：拉取远程 master 最新代码

这一步至关重要！ 防止因本地 master 落后而导致合并冲突或覆盖他人代码。

git pull origin master

这会同步远程 master 的最新提交到本地，保证你的合并基于最新代码。

步骤4：合并功能分支

执行合并操作，将 feature/webaudioapi 的所有更改合并到当前 master 分支：

git merge feature/webaudioapi

合并可能出现的情况：

✅ Fast-forward（快速合并）：如果 master 没有新提交，Git 会直接移动指针，历史呈线性。
Merge commit（合并提交）：如果 master 有新提交，Git 会创建一个合并提交。
❌ Conflict（冲突）：同一文件在两个分支中被修改，需手动解决。

步骤5：处理合并冲突（如有）

当出现冲突时，Git 会在文件中标记如下内容：

<<<<<<< HEAD
当前分支的内容
=======
功能分支的内容
>>>>>>> feature/webaudioapi

你需要：

打开冲突文件，根据业务逻辑选择保留或整合代码
删除 <<<<<<<、=======、>>>>>>> 等标记
保存文件后，执行：

git add <冲突文件名>  # 标记为已解决git commit -m "解决合并冲突：整合音频API配置"

Git 会自动生成合并提交信息，确认即可。

步骤6：推送合并结果到远程仓库

合并完成后，将本地更新推送到 GitHub：

git push origin master

成功后你会看到类似输出：

To https://github.com/xxx/aws-polly.git1f48746..1f2e368  master -> master

这意味着远程 master 分支已更新至最新提交。

步骤7：验证合并结果

为确保一切正常，建议进行以下验证：

# 查看远程仓库地址
git remote -v
# 查看图形化提交历史
git log --oneline --graph --all

你也可以打开 GitHub 项目页面查看 master 分支是否包含新功能的提交记录。

示例输出解读

执行 git merge feature/webaudioapi 后输出：

Updating 1f48746..1f2e368
Fast-forwardREADME.md    | 26 ++++++++++++++++++++++++++README_zh.md | 26 ++++++++++++++++++++++++++frontend.py  | 46 ++++++++++++----------------------------------3 files changed, 64 insertions(+), 34 deletions(-)

说明：

使用了 Fast-forward 合并方式
共修改 3 个文件
新增 64 行，删除 34 行
合并成功！

⚠️ 注意事项（必看！）

合并前务必测试：确保功能分支通过单元测试和集成测试，避免将 Bug 引入主干。
定期同步 master：开发过程中定期从 master 拉取更新，减少后期合并冲突。
认真解决冲突：不要随意删除对方代码，必要时与同事沟通确认。
推送后及时通知团队：让其他成员知道主分支已更新，防止基于旧代码继续开发。
本项目远程仓库地址：https://github.com/xxx/aws-polly.git

常用 Git 命令速查表

命令	作用
`git branch`	查看本地分支
`git checkout <branch>`	切换分支
`git switch master`	切换到 master（推荐新语法）
`git pull origin master`	拉取远程 master 最新代码
`git merge feature/webaudioapi`	合并分支
`git push origin master`	推送本地更改
`git status`	查看工作区状态
`git log --oneline --graph`	查看简洁提交图