Git 分支管理指南：从本地创建到远程协作

一、提交本地更改

在创建新分支前，请确保当前工作区的代码已完成以下操作：

1. 将所有修改添加到暂存区：

bash

git add .

1. 提交代码并添加清晰的描述信息：

bash

git commit -m "本次提交的核心内容描述"

二、创建并切换分支

方法一：分步操作

1. 创建新分支（基于当前所在分支）：

bash

git branch feature/new-function

1. 切换分支：

bash

git checkout feature/new-function

方法二：快捷操作（推荐）

直接创建并切换分支：

bash

git checkout -b feature/new-function

或使用 Git 2.23 + 版本的新命令：

bash

git switch -c feature/new-function

验证分支状态

查看当前分支及所有本地分支：

bash

git branch

当前分支前会显示*标记。

三、推送分支到远程仓库

1. 首次推送需建立本地与远程分支的关联：

bash

git push -u origin feature/new-function

1. 后续推送可简化为：

bash

git push

四、协作开发建议

1. 分支命名规范：

   • 功能分支：feature/功能名称
   • 修复分支：hotfix/问题描述
   • 版本分支：release/v1.0

2. 获取远程更新：

bash

git fetch origin  # 同步远程分支信息
git checkout -t origin/远程分支名  # 拉取并跟踪远程分支

1. 分支清理：

bash

git branch -d 已合并分支名  # 删除本地分支
git push origin --delete 远程分支名  # 删除远程分支

五、常见问题处理

1. 分支关联错误：

bash

git branch --set-upstream-to=origin/远程分支名 本地分支名

1. 远程分支未显示：

bash

git fetch --all  # 强制更新所有远程分支信息

最佳实践

• 每次提交前确保分支代码干净
• 定期同步主分支代码：

bash

git checkout main
git pull origin main
git checkout feature/new-function
git rebase main

• 使用分支可视化工具（如 GitKraken）辅助管理

通过标准化的分支操作流程，团队可有效提升协作效率，降低代码冲突风险。建议根据项目特点制定分支策略，并在开发文档中明确规范。