1. 首页 > 编程开发 > github

「如何在 main 分支外创建开发分支、开发完成后合并回 main」的完整流程

你需要「在 main 分支外创建开发分支、开发完成后合并回 main」的完整实操流程,我会按「新手友好」的方式,从创建分支到合并代码一步步讲解,每个步骤都配命令和效果说明,确保你能直接照着做。

前提准备

  1. 确保你已进入 Git 仓库目录(提示符显示 (main));
  2. 确保工作区无未提交的修改(执行 git status 显示 nothing to commit)。

完整操作流程(开发新功能为例)

步骤 1:创建并切换到开发分支(核心)

开发新功能 / 修复 Bug 时,绝对不要直接在 main 分支操作,先创建专属开发分支(比如 dev-login,命名建议「分支类型 - 功能名」,易懂):
bash
运行
# 创建并切换到 dev-login 分支(一步到位,新手首选)
git checkout -b dev-login
  • 执行后,Git Bash 提示符会从 (main) 变成 (dev-login),说明已切换成功;
  • 验证分支:执行 git branch,输出中 * dev-login 表示当前在开发分支,main 是主分支。

步骤 2:在开发分支编写 / 修改代码

在本地仓库中修改代码(比如新增登录功能、修复 Bug),完成后按常规流程提交到本地开发分支:
bash
运行
# 1. 查看修改的文件(确认要提交的内容)
git status

# 2. 将所有修改加入暂存区
git add .

# 3. 提交到本地 dev-login 分支(备注要清晰)
git commit -m "新增登录功能:完成账号密码验证"

步骤 3:切回 main 分支并拉取最新代码(避免冲突)

合并前先确保 main 分支是最新的(如果是多人协作,这一步至关重要):
bash
运行
# 1. 切换回 main 分支(提示符变回 (main))
git checkout main

# 2. 拉取远程 main 分支的最新代码(多人协作必做)
git pull origin main

步骤 4:将开发分支合并到 main 分支

dev-login 分支的代码合并到 main 分支:
bash
运行
# 合并 dev-login 分支到当前 main 分支
git merge dev-login

两种合并结果处理:

  1. 无冲突(最理想):输出类似 Updating xxx..xxx Fast-forward,说明合并成功;
  2. 有冲突(需手动解决):输出 Automatic merge failed; fix conflicts and then commit the result,表示代码冲突(比如多人修改了同一文件的同一行)。
    • 解决方法:① 打开冲突文件(Git 会在文件中标记冲突区域,格式如下):
      plaintext
      <<<<<<< HEAD (main 分支的代码)
      原代码内容
      =======
      dev-login 分支的修改内容
      >>>>>>> dev-login
      

      ② 手动修改冲突内容(保留正确代码,删除 <<<<<<</=======/>>>>>> 标记);③ 重新提交冲突解决后的代码:
      bash
      运行
      git add .
      git commit -m "合并 dev-login 分支:解决登录功能代码冲突"
      

步骤 5:推送合并后的 main 分支到远程仓库

合并完成后,把本地更新的 main 分支推送到 GitHub,让远程仓库和本地同步:
bash
运行
# 推送 main 分支到远程
git push origin main

步骤 6:(可选)删除无用的开发分支

合并完成且验证代码无误后,可删除本地开发分支(避免分支过多混乱):
bash
运行
# 删除 dev-login 分支
git branch -d dev-login
  • 若分支未合并就删除,Git 会提示报错,需用 git branch -D dev-login(强制删除),但新手慎用。

关键注意事项

  1. 合并前先拉取:多人协作时,合并分支前必须执行 git pull origin main,否则容易出现冲突;
  2. 冲突别怕:冲突是 Git 提醒你「代码有重叠修改」,只需手动选择正确代码即可,解决后提交即可;
  3. 分支命名规范:建议用「类型 - 功能」命名(如 feature-支付功能bugfix-修复登录bug),方便后续追溯;
  4. 不要直接改 main:养成「开发在子分支,合并回 main」的习惯,能最大程度保证主分支代码稳定。

总结

  1. 核心流程:创建开发分支 → 开发提交 → 切回main拉最新 → 合并分支 → 推送main → 删除开发分支
  2. 合并冲突是正常现象,关键是找到冲突区域并手动解决;
  3. 该流程适配所有新功能开发 / BUG 修复场景,是 Git 分支管理的标准最佳实践。
如果合并时遇到具体的冲突报错,或想了解「如何用 PR(拉取请求)在 GitHub 网页端合并分支」(更规范的协作方式),可以告诉我,我会补充对应的操作步骤。

声明:本文网友投稿,观点仅代表作者本人,不代表鲁班SEO赞同其观点或证实其描述。

联系我们

在线咨询:点击这里给我发消息

微信号:

工作日:9:30-18:30,节假日休息