想写点详细的东西,最好是能让新人简单上手的,能日常使用的,懂个大概的;可能不是很官方术语,毕竟目标只是便于新手上路。

基础概念

什么是 Git

Git 是目前世界上最先进的分布式版本控制系统(没有之一)。

先说什么是版本控制。举个例子来说,比如你拿到一个word文件,修改保存,修改再保存,再修改再保存,直到最后满意为止。版本控制就是可以随时查看并还原之前任意一次保存后的文件。

版本控制系统常见的有两种,一种是 SVN 一种是 Git。那么他们两个有什么区别呢?区别在于git是分布式的版本控制系统。再举个例子,账房周先生那里有一本账,每位太太出去逛街后都需要去账房周先生那里登记,平时还好,几位太太基本都不会在账房碰面,毕竟谁也不想让别人说自己花销大。可是每当节日来临,比如中秋节啊,端午节啊之类的,几位太太就难免会碰面,然后发生冲突。这就是 SVN,集中式的,账房那本账一丢,就没有办法统计了。

那什么是git呢?同样是账房周先生的这个例子,区别在与每位太太那里都有一本小帐,每次出去游玩后都可以先记在自己的小帐上,等有需要了再去账房周先生那里登记,这样就算账房那本账丢了,也无需太过与担心。

示例图:

SVN 工作流程图 image-20220301193053263

Git 工作流程图

image-20220301193053263

什么是 Git-Flow

Git-Flow是 Git 提交的规范,毕竟多个工程师开发同一个项目,如果不约定一个提交规范,那么基本不知道提交的是什么,还需要一点一点看提交变动的源码,这样做是很不方便的,所以Git 的提交规范应运而生,用的最多的就是Git-Flow。

基本操作

Git的基本操作

生成 ssh 秘钥

1
2
3
4

cd ~/.ssh   //查询文件夹是否存在,如果存在说明已经生成了ssh秘钥,跳过此步

ssh-keygen -t rsa -C "你公司内部/或者你自己的邮箱地址" //用来生成ssh 秘钥

复制公钥并添加到代码托管平台

1
cat id_rsa.pub   //通过 `cat` 命令查看文件 `id_rsa.pub` 的内容,然后复制

以 Github 为例,如下图所示,进入 settings -> SSH and GPG keys 将复制的内容粘贴过来,点击 add ssh key,这一步等于说把你的公钥放到了 Github 上进行托管。

image-20220301193053263

全局配置用户名和邮箱

1
2
git config --global user.name "你的名字"
git config --global user.email "你公司内部/或者你自己的邮箱地址"

git init

初始化一个空仓库

1
git init

git add

添加文件到暂存区

1
2
3
4
# 添加某个文件到暂存区,后面可以跟多个文件,以空格区分
git add xxx
# 添加当前更改的所有文件到暂存区。
git add .

git commit

提交更改

1
2
3
4
5
6
7
8
# 提交暂存的更改,会新开编辑器进行编辑
git commit 
# 提交暂存的更改,并记录下备注
git commit -m "you message"
# 等同于 git add . && git commit -m
git commit -am
# 对最近一次的提交的信息进行修改,此操作会修改commit的hash值
git commit --amend

git pull

推送代码到远程仓库

1
2
3
4
# 从远程仓库拉取代码并合并到本地,可简写为 git pull 等同于 git fetch && git merge 
git pull <远程主机名> <远程分支名>:<本地分支名>
# 使用rebase的模式进行合并
git pull --rebase <远程主机名> <远程分支名>:<本地分支名>

git fetch

与 git pull 不同的是 git fetch 操作仅仅只会拉取远程的更改,不会自动进行 merge 操作。对你当前的代码没有影响

1
2
3
4
# 获取远程仓库特定分支的更新
git fetch <远程主机名> <分支名>
# 获取远程仓库所有分支的更新
git fetch --all

git branch

分支相关操作

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
# 新建本地分支,但不切换
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

初始化

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
已初始化空的 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? []

image-20220301193053263

一些高的git版本中已经默认集成了git-flow,如果你的版本不支持,可以到github->gitflow查看安装说明

git flow feature

开发一个新功能

1
git flow feature start your-branch-name

start后面一般跟你的新功能名称,它会基于develop 分支为基础创建的这个新的分支,当功能开发完成后,你可以运行:

1
 git flow feature finish your-branch-name

这条命令会将你新开发的功能合并到develop分支并删除该 feature 分支,然后切换回 develop 分支,当然,你可以通过命令git log查看操作历史。

git flow release

发布一个新版本

1
git flow release start v0.0.1

新版本完成测试后就可以发布该分支了,你可以运行:

1
git flow release finish v0.0.1

注意这个 release 版本的命名 我们一般习惯是 v+3 位数 因为这是一个新的项目还没有 tag 标签就从 0 开始了 那就是 v0.0.1 了 当然具体还是看公司规定

git flow hotfix

当我们出现 bug 需要修复又不想影响发布分支 可以新建一个 hotfix 分支来修复 bug,这个是基于master 分支帮我们创建的这个 hotfix 新分支:

1
git flow hotfix start v0.0.1.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,那么远程仓库地址肯定是有变动的,你可以这样做:

1
2
3
4
5
git remote -v  //查看远程仓库地址

git remote rm origin  //删除现有的仓库地址

git remote add origin url  //url是新的仓库地址

使用 git stash 来暂存文件

很常见的情况就是你在开发新功能的时候,生产环境有个bug需要修改,这时你可以用 git stash 命令先把工作区已经修改的文件暂存起来,然后切换到 hotfix 分支上进行 bug 的修复,修复完成后,切换回 feature 分支,从堆栈中恢复刚刚保存的内容。

1
2
3
4
5
6
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.<简化的字符> 原始命令

其他待补充

参考文献

我在工作中是如何使用 git 的

GitFlow日常使用总结