从Git向Git-Flow出发
想写点详细的东西,最好是能让新人简单上手的,能日常使用的,懂个大概的;可能不是很官方术语,毕竟目标只是便于新手上路「阳间的」。
基础概念
什么是 Git
Git 是目前世界上最先进的分布式版本控制系统(没有之一)。
先说什么是版本控制。举个例子来说,比如你拿到一个word文件,修改保存,修改再保存,再修改再保存,直到最后满意为止。版本控制就是可以随时查看并还原之前任意一次保存后的文件。
版本控制系统常见的有两种,一种是 SVN 一种是 Git。那么他们两个有什么区别呢?区别在于git是分布式的版本控制系统。再举个例子,账房周先生那里有一本账,每位太太出去逛街后都需要去账房周先生那里登记,平时还好,几位太太基本都不会在账房碰面,毕竟谁也不想让别人说自己花销大。可是每当节日来临,比如中秋节啊,端午节啊之类的,几位太太就难免会碰面,然后发生冲突。这就是 SVN,集中式的,账房那本账一丢,就没有办法统计了。
那什么是git呢?同样是账房周先生的这个例子,区别在与每位太太那里都有一本小帐,每次出去游玩后都可以先记在自己的小帐上,等有需要了再去账房周先生那里登记,这样就算账房那本账丢了,也无需太过与担心。
示例图:
SVN 工作流程图
Git 工作流程图
什么是 Git-Flow
Git-Flow是 Git 提交的规范,毕竟多个工程师开发同一个项目,如果不约定一个提交规范,那么基本不知道提交的是什么,还需要一点一点看提交变动的源码,这样做是很不方便的,所以Git 的提交规范应运而生,用的最多的就是Git-Flow。
基本操作
Git的基本操作
生成 ssh 秘钥
cd ~/.ssh //查询文件夹是否存在,如果存在说明已经生成了ssh秘钥,跳过此步
ssh-keygen -t rsa -C "你公司内部/或者你自己的邮箱地址" //用来生成ssh 秘钥
复制公钥并添加到代码托管平台
cat id_rsa.pub //通过 `cat` 命令查看文件 `id_rsa.pub` 的内容,然后复制
以 Github 为例,如下图所示,进入 settings -> SSH and GPG keys
将复制的内容粘贴过来,点击 add ssh key
,这一步等于说把你的公钥放到了 Github 上进行托管。
全局配置用户名和邮箱
git config --global user.name "你的名字"
git config --global user.email "你公司内部/或者你自己的邮箱地址"
git init
初始化一个空仓库
git init
git add
添加文件到暂存区
# 添加某个文件到暂存区,后面可以跟多个文件,以空格区分
git add xxx
# 添加当前更改的所有文件到暂存区。
git add .
git commit
提交更改
# 提交暂存的更改,会新开编辑器进行编辑
git commit
# 提交暂存的更改,并记录下备注
git commit -m "you message"
# 等同于 git add . && git commit -m
git commit -am
# 对最近一次的提交的信息进行修改,此操作会修改commit的hash值
git commit --amend
git pull
推送代码到远程仓库
# 从远程仓库拉取代码并合并到本地,可简写为 git pull 等同于 git fetch && git merge
git pull <远程主机名> <远程分支名>:<本地分支名>
# 使用rebase的模式进行合并
git pull --rebase <远程主机名> <远程分支名>:<本地分支名>
git fetch
与 git pull
不同的是 git fetch
操作仅仅只会拉取远程的更改,不会自动进行 merge 操作。对你当前的代码没有影响
# 获取远程仓库特定分支的更新
git fetch <远程主机名> <分支名>
# 获取远程仓库所有分支的更新
git fetch --all
git branch
分支相关操作
# 新建本地分支,但不切换
git branch <branch-name>
# 查看本地分支
git branch
# 查看远程分支
git branch -r
# 查看本地和远程分支
git branch -a
# 删除本地分支
git branch -D <branch-nane>
# 重新命名分支
git branch -m <old-branch-name> <new-branch-name>
git-flow基本操作
git flow init
初始化
已初始化空的 Git 仓库于 /Users/jouzeyu/test/.git/
No branches exist yet. Base branches must be created now.
Branch name for production releases: [master] main //主分支名称,之前是master,现在用main多一些
Branch name for "next release" development: [develop] //开发分支名称,默认就好,下面无特殊要求都默认
How to name your supporting branch prefixes?
Feature branches? [feature/]
Release branches? [release/]
Hotfix branches? [hotfix/]
Support branches? [support/]
Version tag prefix? []
一些高的git版本中已经默认集成了git-flow,如果你的版本不支持,可以到github->gitflow查看安装说明
git flow feature
开发一个新功能
git flow feature start your-branch-name
start后面一般跟你的新功能名称,它会基于develop
分支为基础创建的这个新的分支,当功能开发完成后,你可以运行:
git flow feature finish your-branch-name
这条命令会将你新开发的功能合并到develop
分支并删除该 feature 分支,然后切换回 develop
分支,当然,你可以通过命令git log
查看操作历史。
git flow release
发布一个新版本
git flow release start v0.0.1
新版本完成测试后就可以发布该分支了,你可以运行:
git flow release finish v0.0.1
注意这个 release 版本的命名 我们一般习惯是 v+3 位数 因为这是一个新的项目还没有 tag 标签就从 0 开始了 那就是 v0.0.1 了 当然具体还是看公司规定
git flow hotfix
当我们出现 bug 需要修复又不想影响发布分支 可以新建一个 hotfix
分支来修复 bug,这个是基于master
分支帮我们创建的这个 hotfix
新分支:
git flow hotfix start v0.0.1.1
当我们修复完毕后:
git flow hotfix finish v0.0.1.1
他会在后面帮我们把分支合并到 master
然后打上标签 并删除该分支,同样,你也可以通过命令git log
查看操作历史。
注意这个命名版本号:我们一般习惯使用 v+4 位数来命名版本号 需要先查询最新的一个
release
分支因为 release 是 3 位的 在他的基础上加一位 因为我们上面刚刚完成的 release 版本号是 v0.0.1 所以我们新建的 hotfix 分支的名字就是v0.0.1.1
eg: 如果我们git tag
出的最新 release 为v1.2.3
那我们的 hotfix 分支可以命名为v1.2.3.1
以此类推
工作中git解决问题场景
切换远程仓库地址
比如说,原先是github托管的代码,为了公司的代码安全,切换到了gitlab,那么远程仓库地址肯定是有变动的,你可以这样做:
git remote -v //查看远程仓库地址
git remote rm origin //删除现有的仓库地址
git remote add origin url //url是新的仓库地址
使用 git stash 来暂存文件
很常见的情况就是你在开发新功能的时候,生产环境有个bug需要修改,这时你可以用 git stash
命令先把工作区已经修改的文件暂存起来,然后切换到 hotfix 分支上进行 bug 的修复,修复完成后,切换回 feature 分支,从堆栈中恢复刚刚保存的内容。
git stash //把本地的改动暂存起来
git stash save "message" 执行存储时,添加备注,方便查找。
git stash pop // 应用最近一次暂存的修改,并删除暂存的记录
git stash apply // 应用某个存储,但不会把存储从存储列表中删除,默认使用第一个存储,即 stash@{0},如果要使用其他个,git stash apply stash@{$num} 。
git stash list // 查看 stash 有哪些存储
git stash clear // 删除所有缓存的 stash
使用 git alias 减少操作
你可以用git alias给一些命令配置别名,比如git commit=>git cm,你可以通过下面的命令进行配置:git config --global alias.<简化的字符> 原始命令
其他待补充
参考文献
本作品采用《CC 协议》,转载必须注明作者和本文链接
git flow 这工具挺好用的,很利于团队开发的分支管理规范
从 git flow 向 AGIT 出发?
新手可以稍微看下这个博文和参考文献,边使用 SourceTree 结合起来练手。