Git

# 检出分支到本地新分支、覆盖工作区
git checkout -f -B branchabc remotes/origin/branchabc --

# 添加gpg签名密钥
git config --global user.signingkey 0A46826A

基本操作¶

# 将变更部分变为一段一段patch，再交互式地询问你提交哪部分到暂存区
git add --patch xxx.c

# 检出dev分支
git checkout dev

# 创建分支并切换到该分支
git checkout -b xxx

# 检出某个文件, 还原工作区
git checkout xxx.c

# 把dev合并到当前分支
git merge dev

# 变基到dev分支
git rebase dev

# 查看某文件历史
git log --pretty=oneline xxx.c

# 查看某commit中的变更
git show 7cb554fc6663ea62bae727f1489859947e87c5de

# 删除未跟踪文件 -x连ignore的文件也一起 -d目录
git clean -xfd

# 浅层克隆，用于仓库太大，而只想克隆某分支的场景
git clone --depth=1 -b <branch> <repo>

# 增加tag
git tag -a v1.1.1
git push --tags
# 删除tag
git tag -d v1.1.1
git push --delete orgin v1.1.1

# 获取HEAD的Commit ID
git rev-parse --short HEAD

# 暂存/弹出文件
git stash
git stash pop
# 弹出文件后遇到冲突，取消
git reset --merge

分支操作¶

# 删除分支
git branch -D xxx
# 删除远程分支
git push origin --delete feature/main-functions
# 更新远端跟踪分支
git remote update
# 清理remote追踪分支，比如远端已经删除了，但本地的跟踪分支没删时
git remote prune origin --dry-run

恢复¶

reset¶

使分支指针定向到指定commit记录上, 那之后的提交会丢失.

git reset bf7e5b --hard

--soft 仅重置指针
--mix, 重置指针和index
--hard, 重置指针/index/工作区

revert¶

回滚, 用新提交覆盖.

场景1：release分支中有一份导致bug的feature提交，需要在hotfix分支中回滚

场景2：开发时，本地缺少部分很难处理的依赖，但开发的功能用不到这部分依赖，可以做一个解除依赖的commit（删删删），待开发完功能，再回滚，把特性分支rebase合并提交。

ff合并和合并细节¶

注意到有时执行git merge不会产生合并记录, 这是触发了git的fast-forward功能.

另外, 合并到master似乎默认使用--no-ff方式, 必然产生合并记录.

作者：Chuckiefan

链接：https://www.jianshu.com/p/58a166f24c81

fast-forward合并¶

通常情况下分支合并都会产生一个合并节点，但是在某些特殊情况下例外。例如调用git pull命令更新远端代码时，如果本地的分支没有任何的提交，那么没有必要产生一个合并节点。这种情况下将不会产生一个合并节点，HEAD直接指向更新后的顶端代码，这种合并的策略就是fast-forward合并。

合并细节¶

除了上文所提到的fast-forward合并模式以外，被合并的分支将会通过一个合并节点和当前分支绑在一起，该合并节点同时拥有合并前的当前分支顶部节点和对方分支顶部节点，共同作为父节点。一个合并了的版本将会使所有相关分支的变化一致，包括提交节点，HEAD节点和index指针以及节点树都会被更新。只要这些节点中的文件没有重叠的地方，那么这些文件的变化都会在节点树中改动并更新保存。如果无法明显地合并这些变化，将会发生以下的情况：

HEAD指针所指向的节点保持不变
MERGE_HEAD指针被置于其他分支的顶部
已经合并干净的路径在index文件和节点树中同时更新
对于冲突路径，index文件记录了三个版本：版本1记录了二者共同的祖先节点，版本2记录了当前分支的顶部，即HEAD，版本3记录了MERGE_HEAD。节点树中的文件包含了合并程序运行后的结果。例如三路合并算法会产生冲突。
其他方面没有任何变化。特别地，你之前进行的本地修改将继续保持原样。如果你尝试了一个导致非常复杂冲突的合并，并想重新开始，那么可以使用git merge --abort

关于三路合并算法：三路合并算法是用于解决冲突的一种方式，当产生冲突时，三路合并算法会获取三个节点：本地冲突的B节点，对方分支的C节点，B，C节点的共同最近祖先节点A。三路合并算法会根据这三个节点进行合并。具体过程是，B，C节点和A节点进行比较，如果B，C节点的某个文件和A节点中的相同，那么不产生冲突；如果B或C只有一个和A节点相比发生变化，那么该文件将会采用该变化了的版本；如果B和C和A相比都发生了变化，且变化不相同，那么则需要手动去合并;如果B，C都发生了变化，且变化相同，那么并不产生冲突，会自动采用该变化的版本。最终合并后会产生D节点，D节点有两个父节点，分别为B和C。

无法显示中文问题¶

git config --global core.quotepath false

忽略权限¶

git config core.filemode false

tig¶

tig是git的文字GUI，中文需要安装依赖。

sudo apt install libncursesw5 libncursesw5-dev
git clone https://github.com/jonas/tig.git
cd tig
git checkout -t origin/release
make configure
./configure --prefix=/usr
make
sudo make install install-release-doc

嗯arch下直接yay -S tig就能装好了。

配置在~/.tigrc，man tigrc能看到编写帮助，可以在tig中增加一些自定义操作。

# 查看某文件相关的log(文件夹也一样)
tig xxx.c

使用git diff对比任意文件夹¶

diff <(find /dir1/ -type f -exec md5sum {} + | sort -k 2 | sed 's/ .*\// /') <(find /dir2/ -type f -exec md5sum {} + | sort -k 2 | sed 's/ .*\// /')

git diff --no-index dir1/ dir2/

icdiff¶

改善git diff体验, 双栏 https://github.com/jeffkaufman/icdiff

git config --global icdiff.options '--highlight --line-numbers'
git difftool --extcmd icdiff

git flow¶

https://danielkummer.github.io/git-flow-cheatsheet/ gitflow插件及bash自动完成脚本

yay -S gitflow-avh gitflow-bashcompletion-avh

"next release"分支即开发分支

使用¶

# 建立特性分支
git flow feature start xxx [base]

# 完成特性
# 常用可选项: --rebase合并前变基  --squash合并提交
git flow finish

--rebase效果就只是git rebase:

1560408267269

--squash会把若干commit合并成一个来提交, 并在commit content里生成列表(但留不留这些信息是用户决定的).

crlf设置¶

AutoCRLF
#提交时转换为LF，检出时转换为CRLF <在win下编辑时好用>
git config --global core.autocrlf true

#提交时转换为LF，检出时不转换 <在linux下编辑时好用>
git config --global core.autocrlf input

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

SafeCRLF
#拒绝提交包含混合换行符的文件
git config --global core.safecrlf true

#允许提交包含混合换行符的文件
git config --global core.safecrlf false

#提交包含混合换行符的文件时给出警告
git config --global core.safecrlf warn

git的subtree子树¶

subtree是submodule的_{~改进功能}~类似功能，直接把仓库包含到当前repo下。

todo: git subtree教程

https://segmentfault.com/a/1190000012002151

添加子树¶

到git仓库顶层，输入命令：

$ git subtree add --prefix=ext/myrepo [email protected]:myteam/myrepo.git dev --squash

git会在ext/myrepo目录下，检出指定仓库的dev分支，--squash参数合并历史。

从源仓库拉取子树¶

$ git subtree pull --prefix=ext/myrepo [email protected]:myteam/myrepo.git dev --squash

将子树修改的相关commit推送到源仓库¶

$ git subtree push --prefix=ext/myrepo [email protected]:myteam/myrepo.git dev

git中submodule子模块的添加、使用和删除¶

via: https://blog.csdn.net/guotianqing/article/details/82391665

作者: guotianqing

子模块的添加¶

添加子模块非常简单，命令如下：

git submodule add

其中，url为子模块的路径，path为该子模块存储的目录路径。

执行成功后，git status会看到项目中修改了.gitmodules，并增加了一个新文件（为刚刚添加的路径）

git diff --cached查看修改内容可以看到增加了子模块，并且新文件下为子模块的提交hash摘要

git commit提交即完成子模块的添加

跟踪tag:-b tags/v1.0

子模块的使用¶

克隆项目后，默认子模块目录下无任何内容。需要在项目根目录执行如下命令完成子模块的下载：

git submodule init
git submodule update

或：

git submodule update --init --recursive

执行后，子模块目录下就有了源码，再执行相应的makefile即可。

子模块的更新¶

子模块的维护者提交了更新后，使用子模块的项目必须手动更新才能包含最新的提交。

在项目中，进入到子模块目录下，执行 git pull更新，查看git log查看相应提交。

完成后返回到项目目录，可以看到子模块有待提交的更新，使用git add，提交即可。

删除子模块¶

有时子模块的项目维护地址发生了变化，或者需要替换子模块，就需要删除原有的子模块。

删除子模块：

$ git submodule deinit {MOD_NAME}
$ git rm --cached {MOD_NAME}

完成删除后，提交到仓库即可。

move子模块¶

$ git mv xxx/submodule xxx/new_path

递归重置所有子模块¶

git clean -xfd
git submodule foreach --recursive git clean -xfd
git reset --hard
git submodule foreach --recursive git reset --hard
git submodule update --init --recursive

更换子模块的url¶

修改.gitsubmodule中的url
git submodule sync将url更新到展开的子模块中

修改历史commit¶

进入rebase状态

git rebase -i master~1 #最后一次
git rebase -i master~5 #最后五次
git rebase -i HEAD~3   #当前版本的倒数第三次状态
git rebase -i 32e0a87f #指定的SHA位置

进去编辑界面，将需要修改的commit前的文字，由pick改为edit
命令行显示：

You can amend the commit now, with

 git commit --amend

Once you are satisfied with your changes, run

 git rebase --continue

按照提示修改即可

仓库迁移¶

$ git clone --bare git://oldgithub.com/username/oldproject.git
$ cd oldproject.git
$ git push --mirror [email protected]/username/newproject.git

重置仓库¶

删掉.git目录后重新init在某些时候可用，但拥有submodules之类的时候，就不好使了，这是个更优的方案（https://stackoverflow.com/a/13102849）：

git checkout --orphan newBranch
git add -A  # Add all files and commit them
git commit
git branch -D master  # Deletes the master branch
git branch -m master  # Rename the current branch to master
git push -f origin master  # Force push master branch to github
git gc --aggressive --prune=all     # remove the old files

git reflog expire --expire=now --all
git gc --prune=now
git gc --aggressive --prune=now

为git配置代理¶

git config --global http.proxy http://proxyUsername:[email protected]:port

仅为某些目标配置代理，修改~/.gitconfig：

[http "https://github.com"]
    proxy=socks5://xxxxxx:7890

ssh方式要在~/.ssh/config中配置：

Host github.com
     ProxyCommand /usr/bin/corkscrew r-proxy 7890 %h %p

遇到的问题¶

error: insufficient permission for adding an object to repository database .git/objects¶

权限有问题。

如果是用root或者其他用户操作了git仓库，修复方法：

$ cd .git/objects
$ sudo chown -R 用户名:组 .

备份整个 gitlab 中的仓库¶

gitlabber -t 'your api key' -u 'http://your-gitlab.com/' -m ssh ./gitbackup
tar -czf skgit-$(date +%Y%m%d).tar.gz ./gitbackup

git https方式免密码特性¶

$ git config --global credential.helper store

清空

$ git config --unset credential.helper

$HOME/.gitconfig：

[credential]  
    helper = store