git用法详解

Posted 2022-12-04 一代小强

“教你怎么使用git提升效率“

1、git 入门

配置git信息

$ git config --global user.name "name" //. 设置用户名
$ git config --global user.email [e-mail] //设置邮箱
$ git config --list // 查看所有git的config信息
$ git config user.name // 查看name信息，格式如：git config <key>
$ git init // 初始化git仓库
// 以下有三种方式可以获取对应功能的help，比较有用
$ git help <verb> // 比如获取config的 help： git help config
$ git <verb> --help
$ man git-<verb>
  

基本命令

$ git add $filePath // 将文件添加到git管控
$ git commit -m 'initial project version' // 提交修改信息
$ git commit --amend // 修改当前最后一次commit的信息
$ git commit --amend --no-edit // 只更新修改内容，不修改提交commit信息
$ git clone https://github.com/xxx // 克隆仓库
$ git status //查看修改文件的状态
$ git diff // 查看未暂存的详细修改内容
$ git reset <filePath> // 将已经add的文件移除commit 列表
$ git stash // 将修改暂存到本地
$ git stash list // 获取暂存列表
$ git stash pop // 恢复上次暂存修改  
$ git stash pop stash@0 // 移除暂存栈顶  
$ git stash clear // 将stash list 清空
  

但是如果我们需要指定的commit信息怎么办呢？

2、git log 命令

基本命令

$ git log // 查看所有commit信息
$ git shortlog // 查看简略的log
$ git log --oneline --no-merges tagA ^tagB // 查看tagA tagB之间的log信息
$ git log  --no-merges  tag1..   //在tag1后面加“..”表示获取该tag之后的commit信息
$ git log master..experiment // 查看 experiment 与master的差异，即在 experiment 分支中而不在 master 分支中的提交
$ git log origin/master..HEAD // 查看当前分支的提交与远程的差异（尚未提交的）  
$ git log refA refB ^refC // 所有被 refA 或 refB 包含的但是不被 refC 包含的提交(也可以用于两个分支的比较)
$ git log refA refB --not refC  // 所有被 refA 或 refB 包含的但是不被 refC 包含的提交(也可以用于两个分支的比较)
      

参数：–pretty

• oneline：将commit在一列显示

$ git log --pretty=oneline
ca82a6dff817ec66f44342007202690a93763949 changed the version number
085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7 removed unnecessary test
a11bef06a3f659402fe7563abf99ad00de2209e6 first commit
  
$ git log --oneline // 等效--pretty=oneline 
085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7 removed unnecessary test
$ git reflog // 等效 git log --oneline
e6306e7e7  HEAD@1:  removed unnecessary test
$ git log -g // 查看 reflog 的详细commit信息  

• format：输出指定commit信息

$ git log --pretty=format:"%h - %an, %ar : %s"
ca82a6d - Scott Chacon, 6 years ago : changed the version number
085bb3b - Scott Chacon, 6 years ago : removed unnecessary test
a11bef0 - Scott Chacon, 6 years ago : first commit
  

以下是format具体格式说明，为了方便查阅，这里写成两大列：

选项	说明	选项	说明
%H	提交的完整哈希值	%h	提交的简写哈希值
%T	树的完整哈希值	%t	树的简写哈希值
%P	父提交的完整哈希值	%p	父提交的简写哈希值
%an	作者名字	%ae	作者的电子邮件地址
%ad	作者修订日期（可以用 --date=选项 来定制格式）	%ar	作者修订日期，按多久以前的方式显示
%cn	提交者的名字	%ce	提交者的电子邮件地址
%cd	提交日期	%cr	提交日期（距今多长时间
%s	提交说明

另外还有short，full 和 fuller，这里就不一一列举

**参数：–follow **

获取指定文件的修改历史，例如结合pretty 参数，打印xxx.java 文件的提交历史

$ git log --pretty=oneline --follow app/src/main/java/com/xxx.java
085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7 removed unnecessary test
$  git log --pretty=format:"%cd %an %s"  --follow app/src/main/java/com/xxx.java // 打印历史的提交日期，作者 commit信息
  

参数：-S

获取指定字符串的修改记录，例如：

$ git log -S function_name --follow  app/src/main/java/com/xxxx.java // 在文件中找出关于function_name的提交

参数：–decorate

查看各分支所指的对象（TAG之间的commit）

$ git log --oneline --decorate
f30ab (HEAD -> master, testing) add feature #32 - ability to add new formats to the central interface
34ac2 Fixed bug #1328 - stack overflow under certain conditions
98ca9 The initial commit of my project

查看分支历史，指向情况

$ git log --oneline --decorate --graph --all
* c2b9e (HEAD, master) made other changes
| * 87ab2 (testing) made a change
|/
* f30ab add feature #32 - ability to add new formats to the

其他参数

参数	说明
-<n>	仅显示最近的 n 条提交。如:git log -2
--since, --after	仅显示指定时间之后的提交。如：git log --after 2020-05-23
--until, --before	仅显示指定时间之前的提交。如: git log --before 2020-05-23
--author	仅显示作者匹配指定字符串的提交。如：git log --author=‘demo’
--committer	仅显示提交者匹配指定字符串的提交。如: git log --committer=‘demo’
--grep	仅显示提交说明中包含指定字符串的提交。如：git log --grep ‘fix’
–no-merges	去掉合并提交，如：git log --no-merges

3、git远程仓库

仓库路径

// 查看远程仓库路径
$ git remote -v
origin	https://github.com/schacon/ticgit (fetch)
origin	https://github.com/schacon/ticgit (push)
// 添加远程仓库
$ git remote add origin https://github.com/paulboone/ticgit   //origin 用于替代后面的URL(即git服务器路径)

同步远程仓库

$ git fetch <remote> // 拉取远程所有数据和分支
$ git push origin master // 将本地master推送到远程仓库
$ git push origin master -f // 强制将本地master推送到远程仓库，并覆盖远程master  
$ git push origin master:new_branch // 将本地master推送到远程新的new_branch分支
$ git remote prune origin  // 同步远程仓库分支
$ git branch --merged  // 查看哪些分支已经合并到当前分支，同理 `git branch --no-merged` 是查看未合并的分支
$ git branch --no-merged master // 查看哪些分支没有合并到指定分支，同理 `--merged `
 
  

重命名远程仓库

// 重命名远程仓库
$ git remote rename origin origin1
$ git remote
origin1
// 删除远程仓库
$ git remote remove origin1
  

分支管理

$ git branch // 查看本地仓库所有分支
$ git branch --remote //. 查看远程仓库所有分支  
$ git checkout -b new_branch // 创建新的分支，并切到该分支上
$ git branch -d new_branch // 删除new_branch 分支
$ git checkout new_branch  // 切换到new_branch 分支

$ git push <remote> <branch> // 将当前分支推送到远程branch分支 
$ git push <remote> <branch>:<branch1> // 将本地branch 推送到远程branch1
$ git checkout -b <branch> <remote>/<branch>  // 跟踪远程branch，并将本地分支切换到该branch
  
$ git push origin --delete serverfix  // 删除远程serverfix分支
$ git log featureA..origin/featureA  // 查看 featureA 与 远程featureA的差异（也可以查看其他远程分支）
$ git diff --stat master origin/master // 查看文件改动

打标签

$ git tag // 获取tag list
$ git tag -l "v1.8.5*" // 列举 1.8.5 系列的tag
$ git tag -a <tagname> -m "my version 1.4" // 打tag，并制定comment 信息。其中'-a' 是tag版本；'-m' 是tag 信息，可以不指定
$ git show <tagname> // 查看tag 版本的信息
$ git push origin <tagname> // 将tag  v1.4同步到远程分支 
$ git push origin --tags //将全部的tag提交到远程分支
$ git tag -d <tagname> // 删除指定 tag    
  

别名

如果不想每次都输入完整的命令，可以通过 git config 设置别名，比如：

$ git config --global alias.co checkout
$ git config --global alias.br branch
$ git config --global alias.ci commit // git commit 对应 git ci
$ git config --global alias.unstage 'reset HEAD --' // git reset HEAD 对应git unstage
$ git merge iss53 // 将 iss53  分支合并到当前分支
$ git mergetool  // 启动图形化的合并工具
  

在执行 git commit 的时候，就可以直接输入 git ci

SSH公钥

在Mac上 ，默认情况下，用户的 SSH 密钥存储在其 ~/.ssh 目录下，带pub扩展名的就是公钥

$ cd ~/.ssh
$ ls
id_rsa      id_rsa.pub  known_hosts

如果没有，就新建一个

$ ssh-keygen -o  
Generating public/private rsa key pair.
Enter file in which to save the key (/home/schacon/.ssh/id_rsa):
Created directory '/home/schacon/.ssh'.
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /home/schacon/.ssh/id_rsa.
Your public key has been saved in /home/schacon/.ssh/id_rsa.pub.
The key fingerprint is:
d0:82:24:8e:d7:f1:bb:9b:33:53:96:93:49:da:9b:e3 [e-mail]
  

首先 ssh-keygen 会确认密钥的存储位置（默认是 .ssh/id_rsa），然后它会要求你输入两次密钥口令。 如果你不想在使用密钥时输入口令，将其留空即可。 然而，如果你使用了密码，那么请确保添加了 -o 选项，它会以比默认格式更能抗暴力破解的格式保存私钥。 你也可以用 ssh-agent 工具来避免每次都要输入密码。

4、变基（rebase）

rebase 方式与merge类似，都可以用于分支合并，区别就是rebase可以保持合并后的commit信息整洁，假如现在有两个分支master 和 experiment，公共提交是c2，如图所示：

先切换到experiment分支，然后执行rebase

$ git checkout experiment
$ git rebase master
First, rewinding head to replay your work on top of it...
Applying: added staged command
// 重新切回到master
$ git checkout master
$ git merge experiment

最终merge结果如下图所示，就好像提交历史一直是串行的一样

修改历史

可以通过git stash 命令将当前修改项暂存，如果需要修改最近一次commit信息，就可以通过如下命令：

$ git commit --amend  // 进入编辑页面
// 或者
$ git commit --amend --no-edit // 无编辑的提交

如果需要修改最近的3个提交，可以通过rebase 的方式，如下

$ git rebase -i HEAD~3 

然后会进入编辑框，编辑内容如下，需要注意下面的commit id是反的，最下的a5f4a0d 是最新的提交。

pick f7f3f6d changed my name a bit
pick 310154e updated README formatting and added blame
pick a5f4a0d added cat-file

# Rebase 710f0f8..a5f4a0d onto 710f0f8
#
# Commands:
# p, pick <commit> = use commit
# r, reword <commit> = use commit, but edit the commit message
# e, edit <commit> = use commit, but stop for amending
# s, squash <commit> = use commit, but meld into previous commit
# f, fixup <commit> = like "squash", but discard this commit's log message
# x, exec <command> = run command (the rest of the line) using shell
# b, break = stop here (continue rebase later with 'git rebase --continue')
# d, drop <commit> = remove commit
# l, label <label> = label current HEAD with a name
# t, reset <label> = reset HEAD to a label
# m, merge [-C <commit> | -c <commit>] <label> [# <oneline>]
# .       create a merge commit using the original merge commit's
# .       message (or the oneline, if no original merge commit was
# .       specified). Use -c <commit> to reword the commit message.
 .....

其中，Commands 有列举支持的命令，如果需要修改第三次的提交changed my name a bit ，只需要做如下修改

edit f7f3f6d changed my name a bit
pick 310154e updated README formatting and added blame
pick a5f4a0d added cat-file

然后按 ESC->输入:wq -> 保存并退出后，会有如下提示

$ git rebase -i HEAD~3
Stopped at f7f3f6d... changed my name a bit
You can amend the commit now, with

       git commit --amend

Once you're satisfied with your changes, run

       git rebase --continue

现在HEAD指向了changed my name a bit 提交，可以按照提示进行修改

$ git commit --amend
  

保存后运行，该命令会自动将前两个commit信息提交。如果有多个edit，这个命令会重复这些步骤，直到全部edit完

$ git rebase --continue
  

如果需要放弃当前的编辑，可以使用abort命令

$ git rebase --abort // 放弃当前的修改

revert

git revert 是本质是git cherry-pick 的逆向操作，可以撤销之前的提交，例如

$ git revert commit_id

重新排序

如果需要移除某个修改，或者修改commit顺序，可以通过如下步骤:

pick f7f3f6d changed my name a bit
pick 310154e updated README formatting and added blame
pick a5f4a0d added cat-file
  

修改为:

pick 310154e updated README formatting and added blame
pick f7f3f6d changed my name a bit
  

压缩提交

如果指定为 squash ，git 会把这些commit修改合并提交信息在一起，如果需要合并多个提交，可以这样：

pick f7f3f6d changed my name a bit
squash 310154e updated README formatting and added blame
squash a5f4a0d added cat-file

在保存完commit信息 的时候，就拥有一个包含3个commit的提交

5、git工具

git 搜索

可以通过-n 或者 --line-number 查找 工作目录下的指定字符串，输出的内容包含 “文件+行号+查找内容”

$ git grep -n gmtime_r
compat/gmtime.c:3:#undef gmtime_r
compat/gmtime.c:8:      return git_gmtime_r(timep, &result);

-p 会将字符串的上下文打印出来

$ git grep -p gmtime_r
date.c=static int match_multi_number(timestamp_t num, char c, const char *date,
date.c:         if (gmtime_r(&now, &now_tm))
date.c=static int match_digit(const char *date, struct tm *tm, int *offset, int *tm_gmt)
date.c:         if (gmtime_r(&time, tm)) 

git 还提供了字段提交的搜索

$ git log -S ZLIB_BUF_MAX --oneline  // 搜索提交日志中有关 ZLIB_BUF_MAX 的提交
$ git log -G ZLIB_BUF_MAX --oneline  // 搜索提交日志中有关 ZLIB_BUF_MAX 的提交(更加精确)

重置工具

如果有如下的提交

f7f3f6d changed my name a bit
310154e updated README formatting and added blame

• git reset commit

需要重置f7f3f6d 的提交，使其处于修改状态，可以使用如下命令，使得HEAD指针指向310154e

$ git reset 310154e

或者使用soft指令，该指令会撤销上一次的提交，如果使用git commit 就可以完成新的提交

$ git reset --soft 310154e

• git reset --hard commit

该命令会直接销毁掉之前的提交，并且不会保留任何修改项，看起来像是移动了HEAD指针

$ git reset --hard 310154e

如果需要查看历史变动可以通过reflog 命令，该命令会保存修改历史的commit id，被销毁的commit可以通过该命令找回

$ git reflog
  

• reset指定文件

将指定commit的文件重置

$ git reset f7f3f6d -- demo.txt

合并

在合并中出现冲突，如果不想处理冲突，可以通过abort 参数撤销

$ git merge --abort

如果需要清除掉当前的修改项，重新来，可以用

$ git reset --hard HEAD 
 

忽略掉空白的修改项

$ git merge -Xignore-space-change whitespace

如果需要git在merge的时候，直接选择一边，忽略掉另一个，可以传 -Xours 或者 -Xtheirs，比如合并mundo分支，并接受我们的修改

$ git merge -Xours mundo
Auto-merging hello.rb
Merge made by the 'recursive' strategy.。。。。。

git 文件日志

如果需要查看文件全部提交的日志，可以使用blame，其中的前缀 ^ 指出了该文件自第一次提交后从未修改的那些行。

$ git blame fileName
^1da177e4c3f4 (Linus Torvalds 2005-04-16 15:20:36 -0700 75)
066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 76) ifeq ($(KBUILD_VERBOSE),1)
066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 77)   quiet =
066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 78)   Q =
066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 79) else
066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 80)   quiet=quiet_
066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 81)   Q = @
066b7ed955808 (Michal Marek   2014-07-04 14:29:30 +0200 82) endif

二分查找bug 提交

在排查问题的时候，如果你不知道是哪里出现问题，可以使用 bisect 进行二分查询提交日志

$ git bisect start // 开启二分查询
$ git bisect bad // 告诉git当前所在的提交有问题
$ git bisect good v1.0 // 告诉 bisect 已知的最后一次正常状态是哪次提交
Bisecting: 6 revisions left to test after this
[ecb6e1bc347ccecc5f9350d878ce677feb13d3b2] error handling on repo

Git 发现在你标记为正常的提交（v1.0）和当前的错误版本之间有大约12次提交，于是 Git 检出中间的那个提交。 现在你可以执行测试，看看在这个提交下问题是不是还是存在。假设测试结果是没有问题的，你可以通过 git bisect good 来告诉 Git。

$ git bisect good
Bisecting: 3 revisions left to test after this
[b047b02ea83310a70fd603dc8cd7a6cd13d15c04] secure this thing
  

现在你在另一个提交上了，这个提交是刚刚那个测试通过的提交和有问题的提交的中点。 你再一次执行测试，发现这个提交下是有问题的，因此你可以通过 git bisect bad 告诉 Git：

$ git bisect bad
Bisecting: 1 revisions left to test after this
[f71ce38690acf49c1f3c9bea38e09d82a5ce6014] drop exceptions table
  

直到找到bug的提交根源

$ git bisect bad
506b55293888dae435b7ca84accf52f09040d451 is the first bad commit

当你完成这些操作之后，你应该执行 git bisect reset 重置你的 HEAD 指针到最开始的位置

$ git bisect reset
  

bisect 也可以进行自动化测试，但是需要明确返回值，这里就不做讨论。

子模块

git允许项目中包含多个子模块，可以通过submodule命令指定子模块，如下添加一个DbConnector的库

$ git submodule add https://github.com/chaconinc/DbConnector
Cloning into 'DbConnector'...
remote: Counting objects: 11, done.
remote: Compressing objects: 100% (10/10), done.
remote: Total 11 (delta 0), reused 11 (delta 0)
Unpacking objects: 100% (11/11), done.
Checking connectivity... done.

这个时候就会在主项目下新增一个DbConnector的目录

$ git status
On branch master
Your branch is up-to-date with 'origin/master'.
Changes to be committed:
  (use "git reset HEAD <file>..." to unstage)
	new file:   .gitmodules
	new file:   DbConnector

如果需要指定目录，可以在添加的时候，在命令后面加上不同的路径

执行git diff 会有类似的信息

$ git diff --cached DbConnector
diff --git a/DbConnector b/DbConnector
new file mode 160000
index 0000000..c3f01dc
--- /dev/null
+++ b/DbConnector
@@ -0,0 +1 @@
+Subproject commit c3f01dc8862123d317dd46284b05b6892c7b29bc

当你提交时，会看到类似下面的信息：

$ git commit -am 'added DbConnector module'
[master fb9093c] added DbConnector module
 2 files changed, 4 insertions(+)
 create mode 100644 .gitmodules
 create mode 160000 DbConnector

然后提交到远程分支

$ git push origin master

在clone 包含子模块的项目时候，默认会包含子模块的路径，但是其没有任何文件，需要进行初始化

$ git submodule init
Submodule 'DbConnector' (https://github.com/chaconinc/DbConnector) registered for path 'DbConnector'
$ git submodule update
Cloning into 'DbConnector'...

或者直接执行 git submodule update --init

也可以在初始化的时候，通过--recurse-submodules指定下载全部的子模块

$ git clone --recurse-submodules https://github.com/chaconinc/MainProject

6、配置

git 配置

你可以在 $PREFIX/etc/gitconfig 中获取当前git的基础变量配置，也可以通过命令查支持的config

$ git config

配置你的名字和邮箱地址

$ git config --global user.name "John Doe"
$ git config --global user.email [e-mail]

获取git支持的配置选项

$ man git-config

可以使用 core.editor 配置默认的编辑器，如果没有设置，默认使用vi编辑

$ git config --global core.editor emacs // 配置使用emacs 作为编辑器

commit模版

你可以指定某个路径下的文本作为commit提交的模版，git在提交commit信息的时候，会以改内容作为初始化信息

例如有如下文本 ~/.gitmessage.txt

commit your message here

[feature][projectName] 

然后只需要设置模版路径即可

$ git config --global commit.template ~/.gitmessage.txt
  

当你执行 git commit 的时候就会显示定制的模版内容

user.signingkey

如果需要创建经签署标签，那你可以把GPG签署密钥加到配置中

$ git config --global user.signingkey <gpg-key-id>

你每次运行 git tag 命令时，即可直接签署标签，而无需定义密钥：

$ git tag -s <tag-name>

help.autocorrect

如果打错了一条命令，git会猜测你的意图，如下

$ git chekcout master
git：'chekcout' 不是一个 git 命令。参见 'git --help'。

您指的是这个么？
  checkout

如果你把help.autocorrect 设置成 1，那么git会自动校正并执行

$ git chekcout master
警告：您运行一个不存在的 Git 命令 'chekcout'。继续执行假定您要要运行的
是 'checkout'
在 0.1 秒钟后自动运行...

0.1秒即1/10 秒，如果设置help.autocorrect 为50，那么你就会有5秒的时间响应

Window平台回车键

window与其他平台同步作业的时候，可能会遇到CRLF 问题，因为 Windows 使用回车（CR）和换行（LF）两个字符来结束一行，而 macOS 和 Linux 只使用换行（LF）一个字符。

Git 可以在你提交时自动地把回车和换行