git基础使用

Git版本控制

Git版本控制

安装与概述

安装

# ubuntu
sudo apt-get update
sudo apt-get install git

# mac
brew install git

Git本地仓库

- Directory：根目录，由Git管理的一个目录，包含我们的工作区和Git仓库信息。
- Workspace：工作区，即项目的根目录，但不包括.git目录。
- .git： Git版本库目录，保存了所有的版本信息。该目录会由git初始化仓库的时自动生成。
- Index/Stage(阶段；舞台)： 暂存区，工作区变更，先提交到暂存区，再从暂存区提交到本地仓库。
- Local Repo： 本地仓库，保存了项目所有历史变更版本。
  	- HEAD指针： 表示工作区当前版本，HEAD指向哪个版本，当前工作区就是哪个版本；通过HEAD指针，可以实现版本回退。
- Stash(存放；贮藏)： 工作状态保存栈，用于保存和恢复工作区的临时工作状态（代码状态）。

创建查看

初始

cd existing_folder
git init

查看

查看状态

git status  # 显示工作区状态
git status -s # 显示缩略信息

查看日志

git log  # 产看历史版本的所有信息（包括用户名和日期）
git log --graph --pretty=oneline  # 用带参数的git log，输出的信息会短一些

git log --oneline  # 美化后的日志输出
git log --stat  # 产看提交的简略统计信息

git log -p -2  # 查看最近2次提交的引入差异
git log --since="2021-01-01" --until="2021-06-06" # 查看一段儿时间的日志

git reflog (HEAD@{移动到当前版本需要多少步})

# 搜索
git log -S ZLIB_BUF_MAX --oneline  # 想找到ZLIB_BUF_MAX常量是什么时候引入的，-S选项来显示新增和删除该字符串的提交
git log -L :git_deflate_bound:zlib.c  # 想查看zlib.c文件中git_deflate_bound函数的每一次变更

查看差异

git diff [文件名]  # 将工作区中的文件和暂存区的进行比较
git diff [本地库历史版本] [文件名]  # 将工作区中的文件和本地库历史记录比较，不带文件名的话，会比较多个文件
git diff  # 查看当前与暂存区之间的文件差异
git diff --staged  # 查看已暂存与最后一次提交的文件差异

# 说明：
# 减号表示： 本地仓库的代码
# 加号表示： 工作区的代码

查看其他

git show		# 显示各种类型的对象

git blame filename   # 查看每一行的修改人以及commit-id
git show commit-id   # 查看详细的修改提交记录

搜索

# 很方便地从提交历史、工作目录、甚至索引中查找一个字符串或者正则表达式。

git grep -n gmtime_r  # 查找工作目录的文件，-n选项数来输出 Git 找到的匹配行的行号
git grep -c gmtime_r  # 不想打印所有匹配的项，-c或--count选项输出概述的信息， 其中仅包括那些包含匹配字符串的文件，以及每个文件中包含了多少个匹配
git grep -p gmtime_r *.c  # 关心搜索字符串的上下文，-p或--show-function选项来显示每一个匹配的字符串所在的方法或函数

定位bug提交

 # 启动二分法查找
git bisect start 

# 告诉git当前commit是good/bad，git会自动调整到二分处理范围的那个commit
git bisect bad  # 告诉系统当前所在的提交是有问题的
git bisect good <good_commit>	# 告诉系统已知的最后一次正常状态是哪次提交
# git会发现在good和bad之间检出中间的提交，此时执行测试，查看问题是否还存在
# 若不存在问题，说明问题在这个提交之后，告诉git，然后git会继续寻找
git bisect good
# 若存在问题，说明问题这个提交及之前，git会继续缩小范围
git bisect bad
# 直到缩减范围至一个good与bad紧挨时可以确定产生bad的commit

# 重置HEAD指针到最开始的位置
git bisect reset

管理修改

修改

添加

git add path1  # 添加文件内容至索引
git add .  	# 添加所有变动的文件至索引

移动

git mv file_from file_to # 移动或重命名一个文件、目录或符号链接

删除

git rm 	文件	# 从工作区和索引中删除文件
git branch -d 分支名  # 删除一个已合并的分支(非当前分支)
git branch -D 分支名  # 强行删除分支(未合并则丢失修改)

git clean  # 去除冗余文件或清理工作目录
git clean -f -d  # 移除工作目录中所有未追踪的文件已经空的子目录

记录

git commit -m '修改注释'    # 记录变更到仓库
git commit --amend  # 若是上次commit后未push，直接使用则修改注释重新提交，添加其他文件使用则合并上次的commit使用这次的注释
git reset --soft HEAD^  # 撤销上次commit，不撤销add，再次commit时作用等同amend

注意事项

使用commit命令，漏写参数 -m 选项，则git会默认使用GNU Nano的编缉器打开 .git/COMMIT_EDITMSG 文件。可做两种处理方式：

- 第1种： 可以按 ctrl+x 退出即可， 然后再重新执行 git commit并指定 -m 选项提交代码
- 第2种： 在打开的Nano编缉器中输入提交的注释说明， 再按 ctrl + o 保存， 接着按回车确认文件名， 最后再按ctrl + x退出， 回去之后，git就会提交之前的代码了。

标记

git tag						# 查看标签

git tag -a tag-name -m tag-info  # 创建附注标签
git tag -a tag_name commit-id  # 对以往的记录进行标签

git tag tag-name  			# 创建轻量标签/查看标签内容
git tag tag-name commit-id  # 对以往的记录进行标签 

git pull --tags  			# 拉取所有标签

git push origin tag-name 	# 推送某个标签
git push --tags			 	# 推送所有标签

git tag -d tage-name		# 删除本地标签
git push origin :refs/tags/tag-name  # 删除远程标签

git checkout tag-name  # 签出标签指向的版本

回退

git log  # 查看历史提交版本,只能看到当前版本之前的版本
git reflog  # 查看所有的历史版本

# 工作区回退到某个版本
git reset --hard <commit版本号>
选项说明：
hard  重置： 本地仓库HEAD指针、暂存区、工作区
mixed 重置： 本地仓库HEAD指针、暂存区  【默认值】
soft  重置： 本地仓库HEAD指针

# 例子
git reset --soft HEAD^  # 撤销上次commit，不撤销add
git reset --hard <commit-id>  # 撤销上次commit的内容
git reset --hard HEAD^		# 后退1步(一个^表示后退一步)
git reset --hard HEAD^^		# 回退到上上个版本
git reset --hard HEAD~2		# 后退2步(~后的数字n是后退n步)
git push -f  # 强制提交

撤销

# 场景1： 改乱了工作区的代码，想撤销工作区的代码修改
git checkout -- <file>  # 撤销指定文件的修改
git checkout -- .		# 撤销当前目录下所有修改

# 说明：git checkout会用本地仓库中的版本替换工作区的版本，无论工作区是修改还是删除，都可以“一键还原”。 

# 场景2： 改乱了工作区的代码，提交到了暂存区，同时撤销工作区和暂存区修改：
# 方法一： 
# 撤销暂存区修改
git reset HEAD <file>     # 撤销暂存区指定文件的修改
git reset HEAD            # 撤销暂存区所有修改
# 撤销工作区的代码修改
git checkout -- <file>    # 撤销指定文件的修改
git checkout -- .		  # 撤销当前目录下所有修改
# 方法二：
# 同时撤销暂存区和工作区的修改：
git reset --hard HEAD

分支管理

常用分支

- master 主分支： 该分支是非常稳定的，仅用来发布新版本，不会提交开发代码到这里
- develop 开发分支： 不稳定的，团队成员都把各自代码提交到这里。当需要发布一个新版本，经测试通过后，把dev分支合并到master分支上, 作为一个稳定版本，比如v1.0
- featrue 功能分支： 团队每个人负责不同的功能，分别有各的分支，在各自的分支中干活，适当的时候往 dev开发分支合并代码。

查看

git branch -a			# 所有分支

git branch  			# 本地分支， 当前分支有*
git branch -v 		# 查看每个分支的最后一次提交
git branch --merged # 查看已经合并到当前分支的分支
git branch --no-merged # 查看尚未合并到当前分支的分支

git branch -r  		# 远程分支
git remote show origin  # 查看远程分支详细情况

切换

git branch dev	   	# 创建分支 (开发分支)
git checkout dev   	# 切换本地已存在的分支f1
# 创建+切换
git checkout -b dev # 创建+切换分支
git branch --set-upstream-to=origin/develop dev  # 追踪分支
# 创建+切换+远程
git checkout -b f1 origin/f1  # 跟踪拉去远程分支f1，在本地起名为f1，并切换至分支f1

合并

先合并后解决冲突

指令

git checkout master  # 切换至要合并到的分支master
git merge develop  # 合并需要合并的分支到当前分支
# ---有冲突时，解决冲突
git status  # 查看冲突文件
git add .
git commit -m 'merge ...'
# ---完成合并
git push master

说明

# 步骤
1.找到要合并的分支develop和当前分支master最近的共同祖先commit点
2.若是这个点不是当前分支master最新的点，则会把当前分支masteer的最新的commit和要合并分支develop的最新的commit合并为一个新的commit，若有冲突，则需要解决冲突，提交解决冲突
3.将以上共同祖先commit点后的所有提交点，按照提交时间（不是push时间）的先后顺序依次放到master分支上

# 优缺点
优点：操作简单，按照提交时间排序，提交点完整。
缺点：节点过多，在主分支上有无明确意义节点(自动生成的merge记录)，呈现非整条线性直线的关系。

# 应用场景
对公共仓库代码合并处理时使用
在主分支进行冲突解决

变基

指令

git checkout develop
git rebase master 
# ---有冲突，则解决冲突，提交记录
git add .
git commit -m 'merge...' 
git rebase --continue
# -----
git push develop  # 更新远程仓库引用位置
git checkout master
git merge develop
git push master

说明

# 步骤
1.找到这两个分支（即当前分支develop和变基操作的目标基底分支master） 的最近共同祖先commitId
2.对比当前分支相对于该祖先的历次提交，提取相应的修改并存为临时文件(patch)(这些补丁放到".git/rebase"目录中)
3.将当前分支指向目标master分支最新commit, 最后以此将之前另存为临时文件的修改依序应用。 
4.回到master分支，进行一次快进合并。

# 优缺点
优点：可以对某一段线性提交历史进行编辑、删除、复制、粘贴，提交历史干净简洁，形成线性提交历史。
缺点：如果变基中要打散的提交被其他人正在开发，则会在此次变基提交后，其他人提送代码时需要合并此次变基操作，同时自己在变基后推送代码也需要合并他人的处理，造成工作繁琐且记录中有多条重复记录，造成混乱。

摘录来自: Scott Chacon. “Pro Git。” Apple Books. 

摘录来自: Scott Chacon. “Pro Git。” Apple Books. 

# 应用场景
合并未推送的本地修改分支至公共分支时
在子分支进行冲突解决，注意适用于其他人没有使用变基中要改变的提交进行开发

更详细指令

git rebase -i  [startpoint]  [endpoint]

# 参数
-i：是--interactive，即弹出交互式的界面让用户编辑完成合并操作
[startpoint] [endpoint]则指定了一个编辑区间，如果不指定[endpoint]，则该区间的终点默认是当前分支HEAD所指向的commit(注：该区间指定的是一个前开后闭的区间)。
# 交互指令
pick：正常选中，保留该commit（缩写:p）
reword：选中，保留该commit，但要修改该commit的注释（缩写:r）
edit：选中，保留该commit, rebase时会暂停，允许修改这个commit（缩写:e）
squash：选中，会将当前commit与上一个commit合并，（缩写:s）
fixup：与squash相同，但不会保存当前commit的提交信息（缩写:f）
exec：执行其他shell命令（缩写:x）
drop：丢弃该commit（缩写:d）

合并多个commit为一个完整commit

# 查看提交历史
git log
# 对commit进行rebase操作
git rebase -i HEAD~4  # 最近的4个进行处理
git rebase -i commitId  # 对commitId后的所有commit进行处理
# 对弹窗commands处理
p/r/e/s/f/x/d
# 编辑后保存退出，git 会自动压缩提交历史，
wq
# 如果有冲突，记得解决冲突后，使用 
git rebase --continue # 重新回到当前的 git 压缩过程；
git rebase --abort		# 放弃压缩命令
# 推送到远程仓库
git push -f

将某一段commit粘贴到另一个分支

git rebase [startpoint] [endpoint]  --onto [branchName]

# 对要合并分支处理rebase
git checkout develop
git rebase  90bc0045b^ 5de0da9f2 --onto master
git log  # 最新commit为0c72e64...
git status  # 当前HEAD处于游离状态，指向内容正确但是master分支未改变，需要将master指向需最新commit
# 对master处理
git checkout master
git reset --hard  0c72e64

删除

# 删除一个已合并的分支，注意，无法删除当前所在的分支，需要切换到其它分支，才能删除
git branch -d 分支名

# 如果分支还没有被合并，删除分支将会丢失修改。如果要强行删除，需要使用如下命令：
git branch -D 分支名

暂存

# 保存
git stash   		# 不添加备注
git stash save demo # 添加备注，仅为了区分显示
# 查看
git stash list  # 查看stash了哪些存储
git stash show # 显示做了哪些改动，默认show第一个存储stash@{0},显示其他存贮，后面加stash@{$num}
git stash show -p # 显示第一个存储的改动，如果想显示其他存存储，命令：git stash show  stash@{$num}  -p 

# 恢复
git stash apply   # 应用某个存储,但不会把存储从存储列表中删除，默认使用第一个存储,即stash@{0}，如果要使用其他个，git stash apply stash@{$num} 
git stash pop  # 恢复之前缓存的工作目录，将缓存堆栈中的对应stash删除，并将对应修改应用到当前的工作目录下,默认为第一个stash,即stash@{0}，如果要应用并删除其他stash，git stash pop stash@{$num} 

# 删除
git stash drop stash@{$num} # 丢弃stash@{$num}存储，从列表中删除这个存储
git stash clear # 删除所有缓存的stash

# 从贮藏创建一个分支
git stash branch testchanges  # 以指定的分支名创建一个新分支，检出贮藏工作时所在的提交，重新在那应用工作，然后在应用成功后丢弃贮藏

远程仓库

SSH

Git通信协议

Git支持多种协议，包括SSH, https协议

使用ssh协议速度快，一次配置无扰使用
使用https速度较慢，而且每次通过终端上传代码到远程仓库时，都必须输入账号密码

配置SSH密钥对

# 查看秘钥对(.ssh)
cd ~/.ssh/

# 创建
# 三次回车，生成.ssh目录，id_rsa （私钥）和id_rsa.pub （公钥）
ssh-keygen -t rsa -C youremail@example.com
       
# 查看id_rsa.pub公钥
cat ~/.ssh/id_rsa.pub
    
# 配置到远程仓库的后台ssh

# 验证是否配置成功
ssh -T git@github.com
# 第一次，需要输入“yes”, 若返回类似 “Hi islet1010! You've successfully authenticated”，则配置成功。

签名

# 设置系统级别签名
git config --global user.name [AAA]
git config --global user.email [邮箱地址]
cat .gitconfig

# 查看全局设置
git config --global --list 				

# 取消全局配置
git config --global --unset user.name	
git config --global --unset user.email

# 项目级别签名
cd 项目文件夹
git config user.name [AAA]
git config user.email [邮箱地址]
cat .git/config

关联

新建仓库

git clone xxx  # xxx表示地址
touch README.md
git add README.md
git commit -m "add README"
git push -u origin master

已存在的文件

cd existing_folder
git init
git remote add origin xxx  # xxx表示地址
git add .
git commit -m "Initial commit"
git push -u origin master

已存在仓库

cd existing_repo
git remote rename origin old-origin
git remote add origin xxx  # xxx表示地址
git push -u origin --all
git push -u origin --tags

一份代码多个仓库

多关联，即拉取也推送

# 方法一：需要push两次，但是优点是可以pull两次
git remote add origin2 地址2  # 在gitA项目中添加另一个gitB远程的地址，origin2可以自定义
git pull origin2 master --allow-unrelated-histories   # 先拉取gitB地址上的数据，allow-unrelated-histories是为了解决冲突
git push origin2 master  # 在gitA项目中把项目内容同步到gitB地址中
# --实现推送--
git push origin  master 
git push origin2 master
# --删除--
git remote -v  // 查看此时的包括两个远程地址
git remote rm origin2  // 删除gitB的远程地址
git remote -v  //此时应该只有gitA的远程地址

多推送，一拉取

# 方法二：push一次，注意备用库中不能改主库中相同代码，避免冲突无法推送
git remote set-url --add origin 地址   # 给origin添加一个远程push地址，这样一次push就能同时push到两个地址上面
git remote -v # 查看是否多了一条push地址（这个可不执行）
git push origin master -f    # 一份代码就可以提交到两个git仓库上了，如果第一次推不上去代码，可以使用强推的方式
# --实现推送--
git push
# --删除--
git remote set-url --delete origin 地址

随意配置

# 方法三：直接修改.git/config

# 默认
[remote "origin"]
	url = 地址
	fetch = +refs/heads/*:refs/remotes/origin/*

# 多推送，多拉取
[remote "origin"]
	url = 地址
	fetch = +refs/heads/*:refs/remotes/origin/*
[remote "origin2"]
    url = 地址
    fetch = +refs/heads/*:refs/remotes/origin2/*

# 多推送，一拉取
[remote "origin"]
	url = 地址
	fetch = +refs/heads/*:refs/remotes/origin/*
	url = 地址2

协同

操作远程

git remote show origin  # 查看远程分支情况
git remote update  # 更新本地追踪显示的远程分支

git remote prune origin --dry-run  # 查看远程哪些分支需要清理
git remote prune origin		# 清除无效的远程追踪分支

git remote rename pb paul  # 修改远程仓库pb为paul
git remote remove paul  # 删除远程仓库paul

远程->本地

git fetch origin master  # 从远程获取最新版本，不会自动合并或修改当前的工作
git log -p master..origin/master  # 比对本地master分支和origin/master分支区别
git merge origin/master  # 对本地仓库的master和origin/master进行合并

git pull origin master # 从远程获取最新版本，自动合并远程分支到到当前的工作
git pull --rebase  # 把你的本地当前分支里的每个提交(commit)取消掉，并且把它们临时 保存为补丁(patch)(这些补丁放到".git/rebase"目录中),然后把本地当前分支更新为最新的"origin"分支，最后把保存的这些补丁应用到本地当前分支上。

本地->远程

# 查看本地记录的远程信息
git remote -v  # 查看远程配置

# 远程有此分支
git checkout -b f1 origin/f1  # 跟踪拉去远程分支f1，在本地起名为f1，并切换至分支f1
git branch --set-upstream-to=origin/develop dev  # 本地分支与远程分支未建立关联，需要先建立本地与远程分支的链接关系再拉取

# 远程无此分支
git push --set-upstream origin f1  # 若远程不存在此分支,创建新的远程分支，方法一：追踪push和pull
git puh origin f1  # 方法二，只追踪push

git push  		# 推送本地代码，更新远程引用和相关对象

git push --force  # 强制本地覆盖远程

git push origin --delete serverfix  # 本地推送删除远程分支(服务器会暂存一段儿时间待垃圾回收，故异常删除时可恢复)

忽略

本地远程

概述

.gitignore文件提供了可以忽略提交的文件配置，同时此文件会提交到git仓库中，会影响其他人。

GitHub的示例配置文件：https://github.com/github/gitignore

忽略规则：

在git中如果想忽略掉某个文件，不让这个文件提交到版本库中，可以使用修改根目录中 .gitignore 文件的方法。

# 此为注释 – 将被 Git 忽略
*.sample 　　 # 忽略所有.sample 结尾的文件
!lib.sample 　　 # 但 lib.sample 除外
/TODO 　　 # 仅仅忽略项目根目录下的 TODO 文件，不包括 subdir/TODO
build/ 　　 # 忽略 build/ 目录下的所有文件
doc/*.txt 　　# 会忽略 doc/notes.txt 但不包括 doc/server/arch.txt

规则不生效的解决办法

把某些目录或文件加入忽略规则，按照上述方法定义后发现并未生效，原因是.gitignore只能忽略那些原来没有被追踪的文件，如果某些文件已经被纳入了版本管理中，则修改.gitignore是无效的。那么解决方法就是先把本地缓存删除（改变成未被追踪状态），然后再提交：

git rm -r --cached .
git add .
git commit -m 'update .gitignore'

只本地

.git/info/exclude 设置你自己本地需要排除的文件。不会提交到版本库中去，所以不会影响他人。

# 进入/创建文件进行编辑
vim .git/info/exclude
# 输入忽略内容
*.sample 　　 # 忽略所有.sample 结尾的文件
!lib.sample 　　 # 但 lib.sample 除外
/TODO 　　 # 仅仅忽略项目根目录下的 TODO 文件，不包括 subdir/TODO
build/ 　　 # 忽略 build/ 目录下的所有文件
doc/*.txt 　　# 会忽略 doc/notes.txt 但不包括 doc/server/arch.txt