Git

常用命令

功能	命令
添加文件/更改到暂存区	git add filename
添加所有文件/更改到暂存区	git add .
提交	git commit -m msg
从远程仓库拉取最新代码	git pull origin master
推送到远程仓库	git push origin master
查看配置信息	git config –list
查看文件列表	git ls-files
比较工作区和暂存区	git diff
比较暂存区和版本库	git diff –cached
比较工作区和版本库	git diff HEAD
从暂存区移除文件	git reset HEAD filename
查看本地远程仓库配置	git remote -v
回滚	git reset –hard 提交SHA
强制推送到远程仓库	git push -f origin master
修改上次 commit	git commit –amend
推送 tags 到远程仓库	git push –tags
推送单个 tag 到远程仓库	git push origin [tagname]
删除远程分支	git push origin –delete [branchName]
远程空分支（等同于删除）	git push origin :[branchName]
查看所有分支历史	gitk –all
按日期排序显示历史	gitk –date-order

Q&A

如何解决gitk中文乱码，git ls-files 中文文件名乱码问题？

在~/.gitconfig中添加如下内容

[core]
   quotepath = false
[gui]
   encoding = utf-8
[i18n]
   commitencoding = utf-8
[svn]
   pathnameencoding = utf-8

参考 http://zengrong.net/post/1249.htm

如何处理本地有更改需要从服务器合入新代码的情况？

git stash
git pull
git stash pop

stash

查看 stash 列表：

git stash list

查看某一次 stash 的改动文件列表（不传最后一个参数默认显示最近一次）：

git stash show "stash@{0}"

以 patch 方式显示改动内容

git stash show -p "stash@{0}"

应用某次 stash 改动内容：

git stash apply "stash@{0}"

如何合并 fork 的仓库的上游更新？

git remote add upstream https://upstream-repo-url
git fetch upstream
git merge upstream/master

如何通过 TortoiseSVN 带的 TortoiseMerge.exe 处理 git 产生的 conflict？

将 TortoiseMerge.exe 所在路径添加到 path 环境变量。
运行命令 git config --global merge.tool tortoisemerge 将 TortoiseMerge.exe 设置为默认的 merge tool。
在产生 conflict 的目录运行 git mergetool，TortoiseMerge.exe 会跳出来供你 resolve conflict。
也可以运行 git mergetool -t vimdiff 使用 -t 参数临时指定一个想要使用的 merge tool。

不想跟踪的文件已经被提交了，如何不再跟踪而保留本地文件？

git rm --cached /path/to/file，然后正常 add 和 commit 即可。

如何不建立一个没有 parent 的 branch？

git checkout --orphan newbranch

此时 git branch 是不会显示该 branch 的，直到你做完更改首次 commit。比如你可能会想建立一个空的 gh-pages branch，那么：

git checkout --orphan gh-pages
git rm -rf .
// add your gh-pages branch files
git add .
git commit -m "init commit"

submodule 的常用命令

添加 submodule

git submodule add git@github.com:philsquared/Catch.git Catch

这会在仓库根目录下生成如下 .gitmodules 文件并 clone 该 submodule 到本地。

[submodule "Catch"]
path = Catch
url = git@github.com:philsquared/Catch.git

更新 submodule

git submodule update

当 submodule 的 remote 有更新的时候，需要

git submodule update --remote

当在本地拉取了 submodule 的远程更新，但是想反悔时：

git submodule update --init

删除 submodule

在 .gitmodules 中删除对应 submodule 的信息，然后使用如下命令删除子模块所有文件：

git rm --cached Catch

clone 仓库时拉取 submodule

git submodule update --init --recursive

删除远程 tag

git push origin --delete tag [tagname]

基于某次 commit 创建 tag

git tag <tag name> <commit id>

git tag v1.0.0 ef0120

清除未跟踪文件

git clean

可选项：

选项	含义
-q, –quiet	不显示删除文件名称
-n, –dry-run	试运行
-f, –force	强制删除
-i, –interactive	交互式删除
-d	删除文件夹
-e, –exclude	忽略符合的文件
-x	清除包括 .gitignore 里忽略的文件
-X	只清除 .gitignore 里忽略的文件

忽略文件属性更改

因为临时需求对某个文件 chmod 了一下，结果这个就被记为了更改，有时候这是想要的，有时候这会造成困扰。

git config --global core.filemode false

参考：How do I make Git ignore file mode (chmod) changes?

忽略除某后缀名以外的所有文件

忽略除了 .c 后缀名以外的所有文件。

*
!*.c
!*/

gitignore 里，*、?、[] 可用作通配符。

patch

将未添加到暂存区的更改生成 patch 文件：

git diff > demo.patch

将已添加到暂存区的更改生成 patch 文件：

git diff --cached > demo.patch

合并上面两条命令生成的 patch 文件包含的更改：

git apply demo.patch

将从 HEAD 之前的 3 次 commit 生成 3 个 patch 文件：

（HEAD 可以换成 sha1 码）

git format-patch -3 HEAD

生成 af8e2 与 eaf8e 之间的 commits 的 patch 文件：

（注意 af8e2 比 eaf8e 早）

git format-patch af8e2..eaf8e

合并 format-patch 命令生成的 patch 文件：

git am 0001-Update.patch

与 git apply 不同，这会直接 add 和 commit。

只下载最新代码

git clone --depth 1 git://xxxxxx

这样 clone 出来的仓库会是一个 shallow 的状态，要让它变成一个完整的版本：

git fetch --unshallow

或

git pull --unshallow

基于某次 commit 创建分支

git checkout -b test 5234ab

表示以 commit hash 为 5234ab 的代码为基础创建分支 test。

恢复单个文件到指定版本

git reset 5234ab MainActivity.java

恢复 MainActivity.java 文件到 commit hash 为 5234ab 时的状态。

设置全局 hooks

git config --global core.hooksPath C:/Users/mazhuang/git-hooks

然后把对应的 hooks 文件放在最后一个参数指定的目录即可。

比如想要设置在 commit 之前如果检测到没有从服务器同步则不允许 commit，那在以上目录下建立文件 pre-commit，内容如下：

#!/bin/sh

CURRENT_BRANCH=$(git rev-parse --abbrev-ref HEAD)

git fetch origin $CURRENT_BRANCH

HEAD=$(git rev-parse HEAD)
FETCH_HEAD=$(git rev-parse FETCH_HEAD)

if [ "$FETCH_HEAD" = "$HEAD" ];
then
    echo "Pre-commit check passed"
    exit 0
fi

echo "Error: you need to update from remote first"

exit 1

查看某次 commit 的修改内容

git show <commit-hash-id>

查看某个文件的修改历史

git log -p <filename>

查看最近两次的修改内容

git log -p -2

应用已存在的某次更改 / merge 某一个 commit

git cherry-pick <commit-hash-id>

cherry-pick 有更多详细的用法，可以参见帮助文档。

命令行自动补全

在 shell 里加载 git-completion 系列脚本，详见 https://github.com/git/git/tree/master/contrib/completion

文件每一行变更明细

git blame <filename>

找回曾经的历史

git reflog

列出 HEAD 曾指向过的一系列 commit，它们只存在于本机，不是版本仓库的一部分。

还有：

git fsck

记住 http(s) 方式的用户名密码

在有些情况下无法使用 git 协议，比如公司的 git 服务器设置了 IP 白名单，只能在公司内网使用 ssh，那么在外面就只能使用 http(s) 上传下载源码了，但每次都手动输入用户名/密码特别惨，于是乎就记住吧。

设置记住密码（默认 15 分钟）：

git config --global credential.helper cache

自定义记住的时间（如下面是一小时）：

git config credential.helper 'cache --timeout=3600'

长期存储密码：

git config --global credential.helper store

git commit 使用 vim 编辑 commit message 中文乱码

这个问题在 Windows 下出现了，没找到能完美解决的办法，一种方法是在 vim 打开后输入：

:set termencoding=GBK

这就有点太麻烦了，折衷的方法是改为使用 gVim 或其它你喜欢的编辑器来编辑 commit message：

git config --global core.editor gvim

参考：

另外在升级 Vim 到 8.1 之后，由于 PATH 环境变量里加的还是 vim80 文件夹，导致 git commit 时提示：

error: cannot spawn gvim: No such file or directory
error: unable to start editor 'gvim'
Please supply the message using either -m or -F option.

使用 which gvim 查看：

$ which gvim
/usr/bin/which: no gvim in xxxxxxx

将 PATH 里添加的 vim80 路径改为 vim81 后解决。

git log 中文乱码

只在 Windows 下遇到。

git config --global i18n.logoutputencoding gbk

编辑 git 安装目录下 etc/profile 文件，在最后添加如下内容：

export LESSCHARSET=utf-8

参考：Git for windows 中文乱码解决方案

git diff 中文乱码

只在 Windows 下遇到，目前尚未找到有效办法。

统计代码行数

CMD 下直接执行可能失败，可以在右键，Git Bash here 里执行。

统计某人的代码提交量

git log --author="$(git config --get user.name)" --pretty=tformat: --numstat | gawk '{ add += $1 ; subs += $2 ; loc += $1 - $2 } END { printf "added lines: %s removed lines : %s total lines: %s\n",add,subs,loc }'

按照时间段统计

git log --since=2020-01-01 --until=2020-12-31 --pretty=tformat: --numstat | awk '{ add += $1; subs += $2; loc += $1 - $2 } END { printf "added lines: %s, removed lines: %s, total lines: %s\n", add, subs, loc }' 

按照用户名和时间段统计

git log --author="username" --since=2020-10-01 --until=2020-12-31 --pretty=tformat: --numstat | awk '{ add += $1; subs += $2; loc += $1 - $2 } END { printf "added lines: %s, removed lines: %s, total lines: %s\n", add, subs, loc }' 

仓库提交都排名前 5

如果看全部，去掉 head 管道即可。

git log --pretty='%aN' | sort | uniq -c | sort -k1 -n -r | head -n 5

仓库提交者（邮箱）排名前 5

这个统计可能不太准，可能有同名。

git log --pretty=format:%ae | gawk -- '{ ++c[$0]; } END { for(cc in c) printf "%5d %s\n",c[cc],cc; }' | sort -u -n -r | head -n 5

贡献者排名

git log --pretty='%aN' | sort -u | wc -l

提交数统计

git log --oneline | wc -l

参考：Git代码行统计命令集

修改文件名时的大小写问题

修改文件名大小写时，默认会被忽略（在 Windows 下是这样），让 git 对大小写敏感的方法：

git config --global core.ignorecase false

或者使用 git mv oldname newname 也是可以的。

修复 gitk 在 macOS 下显示模糊的问题

gitk 很方便，但是在 Mac 系统下默认显示很模糊，影响体验。

根据网上搜索的结果，解决方法有两种，我采用第一种解决，第二种未尝试。

方法一：

重新启动机器，按 command + R 等 Logo 和进度条出现，会进入 Recovery 模式，选择顶部的实用工具——终端，运行以下命令：
```
csrutil disable
```
重新启动机器。

编辑 Wish 程序的 plist，启动高分辨率屏支持。

sudo gvim /System/Library/Frameworks/Tk.framework/Versions/Current/Resources/Wish.app/Contents/Info.plist

在最后的 </dict> 前面加上以下代码

<key>NSHighResolutionCapable</key>
<true/>

更新 Wish.app。
```
sudo touch Wish.app
```
再次用 1 步骤的方法进入 Recovery 模式，执行 csrutil enable 启动对系统文件保护，再重启即可。

参考：Mac 中解决 gitk 模糊问题

方法二：

brew cask install retinizer
open /System/Library/Frameworks/Tk.framework/Versions/Current/Resources/

打开 retinizer，将 Wish.app 拖到 retinizer 的界面。

参考：起底Git-Git基础

clone 时指定 master 以外的分支

git clone -b <branch name> --single-branch <repo address>

获取当前分支名称

git symbolic-ref --short -q HEAD

解决 no man viewer handled the request

运行命令 git stash --help 报错：

warning: failed to exec 'man': Invalid argument
fatal: no man viewer handled the request

原因是 Windows 下没有 man 命令。

可以修改 git 配置让命令的帮助文档通过浏览器打开。

git config --global help.format web

比较两个分支的差异

显示出所有差异详情：

git diff <branch_name_1> <branch_name_2>

显示有差异的文件列表：

git diff <branch_name_1> <branch_name_2> --stat

显示指定文件的差异详情：

git diff <branch_name_1> <branch_name_2> <filename>

查看 A 分支有，B 分支没有的提交：

git log <branch_name_A> ^<branch_name_B>

git 操作时报警告

警告信息：

@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@       WARNING: POSSIBLE DNS SPOOFING DETECTED!          @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
The ECDSA host key for gitlab.xxxx.com has changed,
and the key for the corresponding IP address 121.40.151.8
is unknown. This could either mean that
DNS SPOOFING is happening or the IP address for the host
and its host key have changed at the same time.
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
@    WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!     @
@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@
IT IS POSSIBLE THAT SOMEONE IS DOING SOMETHING NASTY!
Someone could be eavesdropping on you right now (man-in-the-middle attack)!
It is also possible that a host key has just been changed.
The fingerprint for the ECDSA key sent by the remote host is
SHA256:bud2tDwxl9687vMOUUBGXlwZhjxDTu7eVF43ojAu1Pw.
Please contact your system administrator.
Add correct host key in /c/Users/mzlogin/.ssh/known_hosts to get rid of this message.
Offending ECDSA key in /c/Users/mzlogin/.ssh/known_hosts:1
ECDSA host key for gitlab.xxxx.com has changed and you have requested strict checking.
Host key verification failed.
fatal: Could not read from remote repository.

Please make sure you have the correct access rights
and the repository exists.

解决方案：

rm ~/.ssh/known_hosts

然后重新操作即可。

删除不存在对应远程分支的本地分支

（本小节有效性存疑，有时候并不好使。）

$ git remote show origin
develop                             tracked
master                              tracked
feature/new-ui                      tracked
refs/remotes/origin/feature/test    stale (use 'git remote prune' to remove)
...

其中 feature/test 就是不存在远程分支的本地分支。

$ git remote prune origin

清除完成。

解决 oh-my-zsh git 进入目录卡顿问题

# 设置 oh-my-zsh 不读取文件变化信息（在 git 项目目录执行下列命令）
git config --add oh-my-zsh.hide-dirty 1
# 设置 oh-my-zsh 不读取任何 git 信息
git config --add oh-my-zsh.hide-status 1
# 恢复显示
git config --remove-section oh-my-zsh

解决 Git 不同平台换行符问题

GNU/Linux和Mac OS使用换行(LF)或新行作为行结束字符，而Windows使用换行和回车(LFCR)组合来表示行结束字符。

为了避免这些行结尾的差异的不必要提交，我们必须配置Git客户端写入与Git仓库使用相同的行结束符。

对于Windows系统，可以将Git客户端配置为将行结束符转换为CRLF格式，同时退出，并在提交操作时将其转换回LF格式。以下可根据需要来设置。

# 提交时转换为LF，检出时转换为CRLF
git config --global core.autocrlf true

# 提交时转换为LF，检出时不转换
git config --global core.autocrlf input

# 提交检出均不转换
git config --global core.autocrlf false

文档信息

本文作者：ChunHui Cao
本文链接：https://monsterCCH.github.io/wiki/git/
版权声明：自由转载-非商用-非衍生-保持署名（创意共享3.0许可证）