Skip to content

YolkPie/git-branch-management

Repository files navigation

git分支管理策略

概述

图片名称

git flow工作流

Git的特色之一就是可以灵活的建立分支,因为有分支的存在,才构成了多工作流的特色。
同时因为其灵活性,也应运而生出分支杂乱的问题,像下图这样:

图片名称

为了解决杂乱的工作流,而产生的分支管理策略

图片名称

三大git分支管理策略

分支

长生命周期分支

  1. 主分支Master

图片名称

有且仅有一个,用于发布版本,每个版本发布需打tag
tag名为 <版本号>_<发布时间>
建议使用--no-ff参数

参数说明

  1. 开发分支Develop

日常开发分支

图片名称

短生命周期分支

  1. 功能分支

为了开发某个功能从dev分支分出来
开发完成后要合并入dev分支
采用fearure-的命名方式
使用后应该删除

图片名称

  1. 预发布分支

在发布正式版本之前用于测试
dev分支分离出来,测试没问题后分别合并进master及dev分支
如发现BUG,从分支分离出fix分支,修复问题后分别合并进该分支及dev分支
采用release-命名方式
使用后应该删除

  1. 修复BUG分支

修复线上BUG分支
master分支分离出来,修复BUG后分别合并进master及dev分支并打好tag
采用fix-[tag]命名方式
使用后应该删除

图片名称

commit message

示例:

git commit -m 'feat(index): 完成sayhello需求开发'
  1. 作用
  • 显示上次发布后的变动
git log <last tag> HEAD --pretty=format:%s
  • 可以过滤某些commit(比如文档改动),便于快速查找信息
git log <last release> HEAD --grep feature
  • 可以直接从commit生成Change log
  1. 格式
<type>(<scope>): <subject>

任何一行都不得超过72个字符,为了避免自动换行影响美观。

  1. 参数说明
  • type(必需)用于说明 commit 的类别

feat: 新功能(feature)
fix: 修补bug
docs: 文档(documentation)
style: 格式(不影响代码运行的变动)
refactor: 重构(即不是新增功能,也不是修改bug的代码变动)
test: 增加测试
chore: 构建过程或辅助工具的变动

  • scope(可选)用于说明 commit 影响的范围
  • subject(必需)commit 目的的简短描述
  1. 工具

1) Commitizen

一个撰写合格 Commit message 的工具。

  • 全局安装
npm install -g commitizen
  • 在项目中初始化
commitizen init cz-conventional-changelog --save --save-exact

git commit命令,一律改为使用git cz

2) validate-commit-msg

校验commit是否符合规范

配置方法

3) conventional-changelog

生成 Change log 的工具

  • 全局安装
npm install -g conventional-changelog-cli
  • 在项目中生成上次发布以来的log
conventional-changelog -p angular -i CHANGELOG.md -w
  • 生成所有发布的change log
conventional-changelog -p angular -i CHANGELOG.md -w -r 0

git使用技巧

  1. 别名
git config alias.co checkout
git config alias.ad 'add .'

之后直接使用git ad \ git co 即可

  1. 超级log
git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"

git config --global alias.llg 'log --graph --decorate --oneline --simplify-by-decoration --all'

应用场景

开发新功能

  1. 自dev分支新建分支feature-sayhello分支
git checkout dev
git pull
git checkout -b feature-sayhello
  1. 开发完成后合并到dev分支,合并前需要先pull远程分支代码,并且在预合并分支处理冲突后再合并
git checkout dev
git pull
git checkout -b merge
git merge --no--ff feature-sayhello
git checkout dev
git merge --no--ff merge
git branch -D merge
  1. 自dev分支创建release-v1.0分支,提交测试
git checkout -b release-v1.0
  1. 测试通过后分别合并至dev分支及master分支,合并前需要先pull远程分支代码,并且预合并分支处理冲突后再合并
git checkout dev
git pull
git checkout -b merge
git merge --no--ff release-v1.0
git checkout dev
git merge --no--ff merge
git branch -D merge
git checkout master
git pull
git checkout -b merge
git merge --no--ff release-v1.0
git checkout master
git merge --no--ff merge
git branch -D merge
  1. 在master分支打上tag
git tag v1.0_21.2.3
git push origin v1.0_21.2.3
  1. 删除开发分支
git branch -D feature-sayhello
git branch -D release-v1.0

修复线上问题

  1. 自master分支新建fixbug分支,指向出问题的tag
git checkout master
git checkout -b fixbug-v1.0 v1.0_21.2.2    
  1. 修复问题并测试通过后分别合并至dev及master分支,合并前需要先pull远程分支代码,并且预合并分支处理冲突后再合并
git checkout dev
git pull
git checkout -b merge
git merge --no--ff fixbug-v1.0
git checkout dev
git merge --no--ff merge
git branch -D merge
git checkout master
git pull
git checkout -b merge
git merge --no--ff fixbug-v1.0
git checkout master
git merge --no--ff merge
git branch -D merge
  1. 在master分支打上tag
git tag v1.3_21.2.2 -m 'fixbug:修复线上问题'
git push origin v1.3_21.2.2
  1. 删除fixbug分支
git branch -D fixbug-v1.0

线上回退至指定tag

  1. 切换至master分支
git checkout master
  1. 指针定向至指定tag
git reset --hard v1.4_21.2.2
  1. 强制推送回滚
git push --force origin master

日常上下班

  1. 下班前commit更改并push至远程
git add .
git commit -m 'docs(readme): MARKDOWN文档书写'
git push
  1. 上班第一件事pull远程dev分支,并合并到自己的开发分支
git checkout dev
git pull
git checkout feature-sayhello
git checkout -b merge
git merge dev
git checkout feature-sayhello
git merge merge
git branch -D merge

说明

--no-ff参数说明

  1. 未使用--no-ff参数

图片名称

  1. 使用--no-ff参数

图片名称

长生命周期分支

三大git分支管理策略

  1. Git Flow是 Vincent Driessen 2010 年发布出来的他自己的分支管理模型,属于强流程性,使用度非常高,比较适合开发技术能力中等的团队作战。
  2. GitHub Flow 是大型程序员交友社区 GitHub 制定并使用的工作流模型,由 scott chacon 在 2011 年 8月 31 号正式发布。
    • 只有一个长期分支 master ,而且 master 分支上的代码,永远是可发布状态,一般 master 会设置 protected 分支保护,只有有权限的人才能推送代码到 master 分支。
    • 如果有新功能开发,可以从 master 分支上检出新分支。
    • 在本地分支提交代码,并且保证按时向远程仓库推送。
    • 当你需要反馈或者帮助,或者你想合并分支时,可以发起一个 pull request。
    • 当 review 或者讨论通过后,代码会合并到目标分支。
    • 一旦合并到 master 分支,应该立即发布。
  3. GitLab Flow是 GitLab 的 CEO Sytse Sijbrandij 在 2014 年 9月 29 正式发布出来的。

分支

标签

列出所有tag

git tag

新建一个tag在当前commit

git tag [tag]

新建一个tag在指定commit

git tag [tag] [commit]

删除本地tag

git tag -d [tag]

删除远程tag

git push origin :refs/tags/[tagName]

查看tag信息

git show [tag]

提交指定tag

git push [remote] [tag]

提交所有tag

git push [remote] --tags

新建一个分支,指向某个tag

git checkout -b [branch] [tag]

延申阅读

Git操作指南: 企业级项目分支管理流程 - SourceTree Mac 版 git 三大分支管理策略

参考资料

git flow分支管理策略 Git flow实践

常用git命令清单 自动化版本控制

commit规范 阮一峰 分支管理项目简单实践 Git 工作流程 Git分支管理实践-撤销

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages