Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/jaywcjlove/git-tips

这里是我的笔记，记录一些git常用和一些记不住的命令。
https://github.com/jaywcjlove/git-tips

git gitbook github tips

Last synced: 6 days ago
JSON representation

这里是我的笔记，记录一些git常用和一些记不住的命令。

Host: GitHub
URL: https://github.com/jaywcjlove/git-tips
Owner: jaywcjlove
Created: 2019-04-12T16:18:28.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2024-06-23T06:43:57.000Z (7 months ago)
Last Synced: 2024-10-29T10:38:55.374Z (2 months ago)
Topics: git, gitbook, github, tips
Language: Markdown
Homepage: https://jaywcjlove.github.io/git-tips
Size: 260 KB
Stars: 427
Watchers: 5
Forks: 132
Open Issues: 0
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

Git Tips
===

[![Buy me a coffee](https://img.shields.io/badge/Buy%20me%20a%20coffee-048754?logo=buymeacoffee)](https://jaywcjlove.github.io/#/sponsor)
[![Gitee Tips](https://jaywcjlove.github.io/sb/ico/gitee.svg)](https://jaywcjlove.gitee.io/git-tips/)
[![CI](https://github.com/jaywcjlove/git-tips/actions/workflows/ci.yml/badge.svg)](https://github.com/jaywcjlove/git-tips/actions/workflows/ci.yml)

一些使用技巧和笔记笔记，记录一些 git 常用和一些记不住的命令，这个笔记原本是基于 [颜海镜的文章](http://yanhaijing.com/git/2014/11/01/my-git-note)增加的，后面慢慢增加了许多内容，独立一个仓库维护，方便查询和使用。

目录
===

- [入门备忘清单](./cheatsheet.md)
- [安装卸载](#安装卸载)
- [配置管理](#配置管理)
- [不常见的使用场景](#不常见的使用场景)
- [忽略文件的权限变化](#忽略文件的权限变化)
- [设置大小写敏感](#设置大小写敏感)
- [配置自动换行](#配置自动换行)
- [创建SSH密钥](#创建ssh密钥)
- [多账号ssh配置](#多账号ssh配置)
- [免密码登录远程服务器](#免密码登录远程服务器)
- [https协议下提交代码免密码](#https协议下提交代码免密码)
- [文件推向3个git库](#文件推向3个git库)
- [修改远程仓库地址](#修改远程仓库地址)
- [撤销远程记录](#撤销远程记录)
- [放弃本地的文件修改](#放弃本地的文件修改)
- [最简单放弃本地修改内容](#最简单放弃本地修改内容)
- [回退到某一个版本](#回退到某一个版本)
- [搜索 commit 历史记录](#搜索-commit-历史记录)
- [回滚到某个commit提交](#回滚到某个commit提交)
- [去掉某个commit](#去掉某个commit)
- [把 A 分支的某一个 commit，放到 B 分支上](#把-a-分支的某一个-commit放到-b-分支上)
- [获取最近一次提交的 commit id](#获取最近一次提交的-commit-id)
- [两个 git 仓库合并](#两个-git-仓库合并)
- [合并多个commit](#合并多个commit)
- [修改远程Commit记录](#修改远程commit记录)
- [利用commit关闭一个issue](#利用commit关闭一个issue)
- [新建一个空分支](#新建一个空分支)
- [添加忽略文件](#添加忽略文件)
- [忽略某个文件的改动](#忽略某个文件的改动)
- [同步fork的上游仓库](#同步fork的上游仓库)
- [手动合并冲突的 Pull Request](#手动合并冲突的-pull-request)
- [修改作者名](#修改作者名)
- [批量修改历史commit中的名字和邮箱](#批量修改历史commit中的名字和邮箱)
- [查看两个星期内的改动](#查看两个星期内的改动)
- [查看某个文件历史](#查看某个文件历史)
- [查看git仓库中最近修改的分支](#查看git仓库中最近修改的分支)
- [更新所有本地分支](#更新所有本地分支)
- [打造自己的git命令](#打造自己的git命令)
- [删除已经合并到 master 的分支](#删除已经合并到-master-的分支)
- [中文乱码的解决方案](#中文乱码的解决方案)
- [提交一个空文件夹](#提交一个空文件夹)
- [新建仓库](#新建仓库)
- [init](#init)
- [status](#status)
- [add](#add)
- [commit](#commit)
- [remote](#remote)
- [push](#push)
- [clone](#clone)
- [本地](#本地)
- [help](#help)
- [add](#add-1)
- [rm](#rm)
- [commit](#commit-1)
- [reset](#reset)
- [revert](#revert)
- [checkout](#checkout)
- [diff](#diff)
- [stash](#stash)
- [merge](#merge)
- [cherry-pick](#cherry-pick)
- [rebase](#rebase)
- [分支branch](#分支branch)
- [删除](#删除)
- [提交](#提交)
- [拉取](#拉取)
- [分支合并](#分支合并)
- [重命名](#重命名)
- [查看](#查看)
- [新建](#新建)
- [连接](#连接)
- [分支切换](#分支切换)
- [远端](#远端)
- [submodule](#submodule)
- [更新 submodule](#更新-submodule)
- [删除 submodule](#删除-submodule)
- [转换分支](#转换分支)
- [删除文件](#删除文件)
- [remote](#remote-1)
- [标签tag](#标签tag)
- [重命名Tag](#重命名tag)
- [日志log](#日志log)
- [重写历史](#重写历史)
- [其它](#其它)
- [报错问题解决](#报错问题解决)
- [参考资料](#参考资料)

## 安装卸载

[官方教程](https://git-scm.com/download/linux)，在 Linux/Unix 系统中，通过工具在中安装 `git`,这种方式比较简单，便于升级卸载工具。

下面介绍在 CentOS 系统中，通过 yum 来安装 git

> **Red Hat Enterprise Linux, Oracle Linux, CentOS, Scientific Linux, et al.**
> RHEL and derivatives typically ship older versions of git. You can [download a tarball](https://www.kernel.org/pub/software/scm/git/) and build from source, or use a 3rd-party repository such as [the IUS Community Project](https://ius.io/) to obtain a more recent version of git.

官方文档说 git 在 `RHEL` 和衍生产品通常都会发布旧版本的 `git`，我们需要源码编译安装，或者使用第三方存储库（如[IUS社区项目](https://ius.io/)）。

现在我们通过，[IUS社区](https://ius.io/GettingStarted/)下载 [ius-release.rpm](https://centos7.iuscommunity.org/ius-release.rpm) 文件进行安装

```bash
# 注意下载不同的版本，本机 CentOS 7
wget https://centos7.iuscommunity.org/ius-release.rpm
# 安装rpm文件
rpm -ivh ius-release.rpm
```

查看可安装的git安装包

```bash
repoquery --whatprovides git
# git-0:1.8.3.1-13.el7.x86_64
# git2u-0:2.16.5-1.ius.centos7.x86_64
# git2u-0:2.16.2-1.ius.centos7.x86_64
# git2u-0:2.16.4-1.ius.centos7.x86_64
# git-0:1.8.3.1-14.el7_5.x86_64
```

**yum 卸载 git 安装新版本**

卸载 `1.8.3` 的 `git`，安装 `2.16.5` 的 `git`

```bash
# 卸载老的版本
yum remove git
# 安装新的版本
yum install git2u
```

## 配置管理

首先是配置帐号信息 `ssh -T [email protected]` 测试。

```bash
git help config # 获取帮助信息，查看修改个人信息的参数
git config --list # 查看配置的信息
git config --global user.name "小弟调调" # 修改全局名字
git config --global user.email "[email protected]" # 修改全局邮箱
git config --global --unset # 删除全局设置
```

## 不常见的使用场景

### 忽略文件的权限变化

不再将文件的权限变化视作改动

```bash
git config core.fileMode false
```

### 设置大小写敏感

```bash
git config --get core.ignorecase # 查看git 的设置
git config core.ignorecase false # 设置大小写敏感
git rm -r --cached <目录/文件> # 远程有俩相同目录，通过这种方式清除掉，然后提交记录
```

### 配置自动换行

自动转换坑太大，提交到git是自动将换行符转换为lf

```bash
git config --global core.autocrlf input
```

### 创建SSH密钥

这个密钥用来跟 github 通信，在本地终端里生成然后上传到 github

```bash
ssh-keygen -t rsa -C '[email protected]' # 生成密钥
ssh-keygen -t rsa -C "[email protected]" -f ~/.ssh/ww_rsa # 指定生成目录文件名字
ssh -T [email protected] # 测试是否成功
```

### 多账号ssh配置

**1.生成指定名字的密钥**

`ssh-keygen -t rsa -C "邮箱地址" -f ~/.ssh/jslite_rsa`
会生成 `jslite_rsa` 和 `jslite_rsa.pub` 这两个文件

**2.密钥复制到托管平台上**

`vim ~/.ssh/jslite_rsa.pub`
打开公钥文件 `jslite_rsa.pub` ，并把内容复制至代码托管平台上

**3.修改config文件**

`vim ~/.ssh/config` #修改config文件，如果没有创建 `config`

```shell
Host jslite.github.com
HostName github.com
User git
IdentityFile ~/.ssh/jslite_rsa

Host work.github.com
HostName github.com
# Port 服务器open-ssh端口（默认：22,默认时一般不写此行）
# PreferredAuthentications 配置登录时用什么权限认证
# publickey|password publickey|keyboard-interactive等
User git
IdentityFile ~/.ssh/work_rsa
```

- `Host` 这里是个别名可以随便命名
- `HostName` 一般是网站如：`[email protected]:username/repo.git` 填写 `github.com`
- `User` 通常填写`git`
- `IdentityFile` 使用的公钥文件地址

**4.测试**

```bash
ssh -T [email protected] # `@`后面跟上定义的Host
ssh -T work.github.com # 通过别名测试
ssh -i ~/公钥文件地址 Host别名 # 如 ssh -i ~/.ssh/work_rsa work.github.com
```

**5.使用**

```bash
# 原来的写法
git clone [email protected]:/learngit.git
# 现在的写法
git clone [email protected]:/learngit.git
git clone [email protected]:/learngit.git
```

**5.注意**

如果你修改了id_rsa的名字，你需要将ssh key添加到SSH agent中，如：

```bash
ssh-add ~/.ssh/jslite_rsa
ssh-add -l # 查看所有的key
ssh-add -D # 删除所有的key
ssh-add -d ~/.ssh/jslite_rsa # 删除指定的key
```

### 免密码登录远程服务器

```bash
$ ssh-keygen -t rsa -P '' -f ~/.ssh/aliyunserver.key
$ ssh-copy-id -i ~/.ssh/aliyunserver.key.pub [email protected] # 这里需要输入密码一次
```

编辑 `~/.ssh/config`

```bash
Host aliyun1
HostName 192.168.182.112
User root
PreferredAuthentications publickey
IdentityFile ~/.ssh/aliyunserver.key
```

上面配置完了，可以通过命令登录，不需要输入IP地址和密码 `ssh aliyun1`

### https协议下提交代码免密码

```bash
git clone https://github.com/username/rep.git
```

通过上面方式克隆可能需要密码，解决办法：进入当前克隆的项目 `vi rep/.git/config` 编辑 `config`, 按照下面方式修改，你就可以提交代码不用输入密码了。

```diff
[core]
repositoryformatversion = 0
filemode = true
bare = false
logallrefupdates = true
ignorecase = true
precomposeunicode = true
[remote "origin"]
- url = https://github.com/username/rep.git
+ url = https://用户名:密码@github.com/username/rep.git
fetch = +refs/heads/*:refs/remotes/origin/*
[branch "master"]
remote = origin
merge = refs/heads/master
```

### 文件推向3个git库

**1. 增加3个远程库地址**

```shell
git remote add origin https://github.com/JSLite/JSLite.git
git remote set-url --add origin https://gitlab.com/wang/JSLite.js.git
git remote set-url --add origin https://oschina.net/wang/JSLite.js.git
```

**2. 删除其中一个 set-url 地址**

```shell
usage: git remote set-url [--push] []
or: git remote set-url --add
or: git remote set-url --delete
```

`git remote set-url --delete origin https://oschina.net/wang/JSLite.js.git`

**3.推送代码**

```bash
git push origin master
git push -f origin master # 强制推送
```

**4.拉代码**

只能拉取 `origin` 里的一个url地址，这个fetch-url
默认为你添加的到 `origin`的第一个地址

```shell
git pull origin master
git pull --all # 获取远程所有内容包括tag
git pull origin next:master # 取回origin主机的next分支，与本地的master分支合并
git pull origin next # 远程分支是与当前分支合并

# 上面一条命令等同于下面两条命令
git fetch origin
git merge origin/next
```

如果远程主机删除了某个分支，默认情况下，git pull 不会在拉取远程分支的时候，删除对应的本地分支。这是为了防止，由于其他人操作了远程主机，导致git pull不知不觉删除了本地分支。
但是，你可以改变这个行为，加上参数 -p 就会在本地删除远程已经删除的分支。

```shell
$ git pull -p
# 等同于下面的命令
$ git fetch --prune origin
$ git fetch -p
```

**5.更改pull**

只需要更改config文件里，那三个url的顺序即可，fetch-url会直接对应排行第一的那个utl连接。

### 修改远程仓库地址

```bash
git remote remove origin # 删除该远程路径
git remote add origin [email protected]:JSLite/JSLite.git # 添加远程路径
```

### 撤销远程记录

```shell
git reset --hard HEAD~1 # 撤销一条记录
git push -f origin HEAD:master # 同步到远程仓库
```

### 放弃本地的文件修改

```shell
git reset --hard FETCH_HEAD # FETCH_HEAD表示上一次成功git pull之后形成的commit点。然后git pull
```

`git reset --hard FETCH_HEAD` 出现错误

```bash
git pull
You are not currently on a branch, so I cannot use any
'branch..merge' in your configuration file.
Please specify which remote branch you want to use on the command
line and try again (e.g. 'git pull ').
See git-pull(1) FOR details.
```

解决方法：

```bash
git checkout -b temp # 新建+切换到temp分支
git checkout master
```

### 最简单放弃本地修改内容

```bash
# 如果有的修改以及加入暂存区的话
git reset --hard
# 还原所有修改，不会删除新增的文件
git checkout .
# 下面命令会删除新增的文件
git clean -xdf
```

通过存储暂存区stash，在删除暂存区的方法放弃本地修改。

```bash
git stash && git stash drop
```

### 回退到某一个版本

```bash
git reset --hard
# 例如 git reset --hard a3hd73r
# --hard代表丢弃工作区的修改，让工作区与版本代码一模一样，与之对应，
# --soft参数代表保留工作区的修改。
```

### 搜索 commit 历史记录

```shell
git log --grep=224
# 这条命令是查看含有 "224" 关键字的 git commit
```

### 回滚到某个commit提交

```shell
git revert HEAD~1 # 撤销一条记录会弹出 commit 编辑
git push # 提交回滚
```

### 去掉某个commit

```bash
# 实质是新建了一个与原来完全相反的commit，抵消了原来commit的效果
git revert
```

### 把 A 分支的某一个 commit，放到 B 分支上

对两个分支，同时都拥有的文件，进行修改后，再同时 `commit` 到这两个分支，比如 `master` 分支和 `branch1` 分支，都拥有文件 `test.js` ，在 `master` 或者 `branch1` 分支下对 `test.js` 进行修改后，把修改的 `test.js` 同时提交到 `master` 分支和 `branch1` 分支。

```bash
git checkout && git cherry-pick
```

### 获取最近一次提交的 commit id

```bash
git rev-parse HEAD # e10721cb8859b2cd340d31a52ef4bf4b9629ddda
git rev-parse --short HEAD # e10721c
```

### 两个 git 仓库合并

现在有两个仓库 [kktjs/kkt](https://github.com/kktjs/kkt.git) 和 [kktjs/kkt-next](https://github.com/kktjs/kkt-next.git) 我们需要将 `kkt-next` 仓库合并到 `kkt` 并保留 `kkt-next` 的所有提交内容。

```bash
# 1. 克隆主仓库代码
git clone [email protected]:kktjs/kkt.git
# 2. 将 kkt-next 作为远程仓库，添加到 kkt 中，设置别名为 other
git remote add other [email protected]:kktjs/kkt-next.git
# 3. 从 kkt-next 仓库中拉取数据到本仓库
git fetch other
# 4. 将 kkt-next 仓库拉取的 master 分支作为新分支 checkout 到本地，新分支名设定为 kkt-next
git checkout -b kkt-next other/master
# 5. 切换回 kkt 的 master 分支
git checkout master
# 6. 将 kkt-next 合并入 kkt 的 master 分支
git merge kkt-next
# 如果第 6 步报错 `fatal: refusing to merge unrelated histories`
# 请执行下面命令 ↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓
git merge kkt-next --allow-unrelated-histories
```

在合并时有可能两个分支对同一个文件都做了修改，这时需要解决冲突，对文本文件来说很简单，根据需要对冲突的位置进行处理就可以。对于二进制文件，需要用到如下命令:

```bash
git checkout --theirs YOUR_BINARY_FILES # 保留需要合并进来的分支的修改
git checkout --ours YOUR_BINARY_FILES # 保留自己的修改
git add YOUR_BINARY_FILES
```

### 合并多个commit

```bash
# 这个命令，将最近4个commit合并为1个，HEAD代表当前版本。
# 将进入VIM界面，你可以修改提交信息。
git rebase -i HEAD~4
# 可以看到其中分为两个部分，上方未注释的部分是填写要执行的指令，
# 而下方注释的部分则是指令的提示说明。指令部分中由前方的命令名称、commit hash 和 commit message 组成
# 当前我们只要知道 pick 和 squash 这两个命令即可。
# --> pick 的意思是要会执行这个 commit
# --> squash 的意思是这个 commit 会被合并到前一个commit

# 我们将需要保留的这个 commit 前方的命令改成 squash 或 s，然后输入:wq以保存并退出
# 这是我们会看到 commit message 的编辑界面

# 其中, 非注释部分就是两次的 commit message, 你要做的就是将这两个修改成新的 commit message。
#
# 输入wq保存并推出, 再次输入git log查看 commit 历史信息，你会发现这两个 commit 已经合并了。
# 将修改强制推送到前端
git push -f origin master
```

### 修改远程Commit记录

```bash
git commit --amend
# amend只能修改没有提交到线上的，最后一次commit记录
git rebase -i HEAD~3
# 表示要修改当前版本的倒数第三次状态
# 将要更改的记录行首单词 pick 改为 edit
pick 96dc3f9 doc: Update quick-start.md
pick f1cce8a test(Transition):Add transition test (#47)
pick 6293516 feat(Divider): Add Divider component.
# Rebase eeb03a4..6293516 onto eeb03a4 (3 commands)
#
# Commands:
# p, pick = use commit
# r, reword = use commit, but edit the commit message
# e, edit = use commit, but stop for amending
# s, squash = use commit, but meld into previous commit
# f, fixup = like "squash", but discard this commit's log message
# x, exec = run command (the rest of the line) using shell
# d, drop = remove commit
```

保存并退出，会弹出下面提示

```bash
# You can amend the commit now, with
#
# git commit --amend
#
# Once you are satisfied with your changes, run
#
# git rebase --continue

# 通过这条命令进入编辑页面更改commit，保存退出
git commit --amend
# 保存退出确认修改，继续执行 rebase,
git rebase --continue
# 如果修改多条记录反复执行上面两条命令直到完成所有修改

# 最后，确保别人没有提交进行push，最好不要加 -f 强制推送
git push -f origin master
```

### 利用commit关闭一个issue

这个功能在Github上可以玩儿，Gitlab上特别老的版本不能玩儿哦，那么如何跟随着commit关闭一个issue呢? 在confirm merge的时候可以使用一下命令来关闭相关issue:

`fixes #xxx`、 `fixed #xxx`、 `fix #xxx`、 `closes #xxx`、 `close #xxx`、 `closed #xxx`、

### 新建一个空分支

```bash
# 这种方式新建的分支(gh-pages)是没有 commit 记录的
git checkout --orphan gh-pages
# 删除新建的gh-pages分支原本的内容，如果不删除，提交将作为当前分支的第一个commit
git rm -rf .
# 查看一下状态有可能上面一条命令，没有删除还没有提交的的文件
git state
```

### 添加忽略文件

```
echo node_modules/ >> .gitignore
```

### 忽略某个文件的改动

```bash
git update-index --assume-unchanged path/to/file # 关闭 track 指定文件的改动，也就是 Git 将不会在记录这个文件的改动
git update-index --no-assume-unchanged path/to/file # 恢复 track 指定文件的改动
```

### 同步fork的上游仓库

[Github教程同步fork教程](https://help.github.com/articles/syncing-a-fork/)，[在Github上同步一个分支(fork)](http://www.miss77.net/549.html)

**设置添加多个远程仓库地址。**

在同步之前，需要创建一个远程点指向上游仓库(repo).如果你已经派生了一个原始仓库，可以按照如下方法做。

```shell
$ git remote -v
# List the current remotes （列出当前远程仓库）
# origin https://github.com/user/repo.git (fetch)
# origin https://github.com/user/repo.git (push)
$ git remote add upstream https://github.com/otheruser/repo.git
# Set a new remote (设置一个新的远程仓库)
$ git remote -v
# Verify new remote (验证新的原唱仓库)
# origin https://github.com/user/repo.git (fetch)
# origin https://github.com/user/repo.git (push)
# upstream https://github.com/otheruser/repo.git (fetch)
# upstream https://github.com/otheruser/repo.git (push)
```

**同步更新仓库内容**

同步上游仓库到你的仓库需要执行两步：首先你需要从远程拉去，之后你需要合并你希望的分支到你的本地副本分支。从上游的存储库中提取分支以及各自的提交内容。 `master` 将被存储在本地分支机构 `upstream/master`

```shell
git fetch upstream
# remote: Counting objects: 75, done.
# remote: Compressing objects: 100% (53/53), done.
# remote: Total 62 (delta 27), reused 44 (delta 9)
# Unpacking objects: 100% (62/62), done.
# From https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY
# * [new branch] master -> upstream/master
```

检查你的 fork's 本地 `master` 分支

```shell
git checkout master
# Switched to branch 'master'
```

合并来自 `upstream/master` 的更改到本地 master 分支上。这使你的前 fork's `master` 分支与上游资源库同步，而不会丢失你本地修改。

```shell
git merge upstream/master
# Updating a422352..5fdff0f
# Fast-forward
# README | 9 -------
# README.md | 7 ++++++
# 2 files changed, 7 insertions(+), 9 deletions(-)
# delete mode 100644 README
# create mode 100644 README.md
```

### 手动合并冲突的 Pull Request

以 [tsbbjs/tsbb](https://github.com/tsbbjs/tsbb) 为例，合并来自 [jaywcjlove/tsbb](https://github.com/jaywcjlove/tsbb) master分支的 `Pull Request`。

```bash
# 1. 克隆主仓库
git clone [email protected]:tsbbjs/tsbb.git
# 2. 在主仓库 master 分支切个 jaywcjlove-master 分支出来，并且切换到 jaywcjlove-master 分支
git checkout -b jaywcjlove-master master
# 3. 获取 jaywcjlove/tsbb 仓库 master 分支最新代码
git pull https://github.com/jaywcjlove/tsbb.git master
# ⚠️ 注意下面是输出内容：
# ----------------------
# Auto-merging src/babel/transform.ts
# CONFLICT (content): Merge conflict in src/babel/transform.ts
# ----------------------
# ⚠️ 注意上面 CONFLICT 标识是有冲突无法自动合并的代码，根据路径进入代码手动合并
# 4. 合并完成之后，进行 commit 说明合并内容
git commit -m "Merge branch 'master' of github.com:jaywcjlove/tsbb #3"
# 5. 切换到 master 分支，如果是 PR 其它分支，这里就切其它分支
git checkout master
# 6. 合并 jaywcjlove-master 分支的代码
git merge --no-ff jaywcjlove-master
# 7. 提交代码
git push origin master
```

### 修改作者名

```
git commit --amend --author='Author Name '
```

### 批量修改历史commit中的名字和邮箱

这是 [Github官方教程](https://help.github.com/articles/changing-author-info/)

**1.克隆仓库**

注意参数，这个不是普通的clone，clone下来的仓库并不能参与开发

```bash
git clone --bare https://github.com/user/repo.git
cd repo.git
```

**2.命令行中运行代码**

OLD_EMAIL原来的邮箱
CORRECT_NAME更正的名字
CORRECT_EMAIL更正的邮箱

将下面代码复制放到命令行中执行

```bash
git filter-branch -f --env-filter '
OLD_EMAIL="[email protected]"
CORRECT_NAME="小弟调调"
CORRECT_EMAIL="更正的邮箱@qq.com"
if [ "$GIT_COMMITTER_EMAIL" = "$OLD_EMAIL" ]
then
export GIT_COMMITTER_NAME="$CORRECT_NAME"
export GIT_COMMITTER_EMAIL="$CORRECT_EMAIL"
fi
if [ "$GIT_AUTHOR_EMAIL" = "$OLD_EMAIL" ]
then
export GIT_AUTHOR_NAME="$CORRECT_NAME"
export GIT_AUTHOR_EMAIL="$CORRECT_EMAIL"
fi
' --tag-name-filter cat -- --branches --tags
```

执行过程

```bash
Rewrite 160d4df2689ff6df3820563bfd13b5f1fb9ba832 (479/508) (16 seconds passed, remaining 0 predicted)
Ref 'refs/heads/dev' was rewritten
Ref 'refs/heads/master' was rewritten
```

**3.同步到远程仓库**

同步到push远程git仓库

```bash
git push --force --tags origin 'refs/heads/*'
```

我还遇到了如下面错误，lab默认给master分支加了保护，不允许强制覆盖。`Project(项目)`->`Setting`->`Repository` 菜单下面的`Protected branches`把master的保护去掉就可以了。修改完之后，建议把master的保护再加回来，毕竟强推不是件好事。

```bash
remote: GitLab: You are not allowed to force push code to a protected branch on this project.
```

当上面的push 不上去的时候，先 `git pull` 确保最新代码

```bash
git pull --allow-unrelated-histories
# 或者指定分枝
git pull origin master --allow-unrelated-histories
```

**4. 删除仓库**

```bash
cd ..
rm -rf repo.git
```

### 查看两个星期内的改动

```
git whatchanged --since='2 weeks ago'
```

### 查看某个文件历史

```shell
git log --pretty=oneline 文件名 # 列出文件的所有改动历史
git show c178bf49 # 某次的改动的修改记录
git log -p c178bf49 # 某次的改动的修改记录
git blame 文件名 # 显示文件的每一行是在那个版本最后修改。
git whatchanged 文件名 # 显示某个文件的每个版本提交信息：提交日期，提交人员，版本号，提交备注（没有修改细节）
```

### 查看git仓库中最近修改的分支

```bash
git for-each-ref --count=30 --sort=-committerdate refs/heads/ --format='%(refname:short)'
```

### 更新所有本地分支

```bash
git branch \
--format "%(if)%(upstream:short)%(then)git push . %(upstream:short):%(refname:short)%(end)" |
sh
```

### 打造自己的git命令

```sh
git config --global alias.st status
git config --global alias.br branch
git config --global alias.co checkout
git config --global alias.ci commit
```

配置好后再输入git命令的时候就不用再输入一大段了，例如我们要查看状态，只需：

```sh
git st
```

### 删除已经合并到 master 的分支

```bash
git branch --merged master | grep -v '^\*\| master' | xargs -n 1 git branch -d
```

### 中文乱码的解决方案

```bash
git config --global core.quotepath false
```

### 提交一个空文件夹

在空文件夹中建立一个文件 `.gitkeep`, 你就可以提交这个空文件夹了。

## 新建仓库

### init

`git init` #初始化

### status

`git status` #获取状态

### add

`git add file` # .或*代表全部添加
`git rm --cached ` # 在commit之前撤销git add操作
`git reset head` # 好像比上面`git rm --cached`更方便

### commit

`git commit -m "message"` #此处注意乱码

### remote

`git remote add origin [email protected]:JSLite/test.git` #添加源

### push

```bash
git push -u origin master # push同事设置默认跟踪分支
git push origin master
git push -f origin master # 强制推送文件，缩写 -f（全写--force）
```

## clone

```bash
git clone git://github.com/JSLite/JSLite.js.git
git clone git://github.com/JSLite/JSLite.js.git --depth=1
git clone git://github.com/JSLite/JSLite.js.git mypro # 克隆到自定义文件夹
git clone [user@]example.com:path/to/repo.git/ # SSH协议还有另一种写法。
```

git clone支持多种协议，除了HTTP(s)以外，还支持SSH、Git、本地文件协议等，下面是一些例子。`git clone <版本库的网址> <本地目录名>`

```shell
$ git clone http[s]://example.com/path/to/repo.git/
$ git clone ssh://example.com/path/to/repo.git/
$ git clone ssh://example.com/path/to/repo.git/
$ git clone git://example.com/path/to/repo.git/
$ git clone /opt/git/project.git
$ git clone file:///opt/git/project.git
$ git clone ftp[s]://example.com/path/to/repo.git/
$ git clone rsync://example.com/path/to/repo.git/
```

## 本地

### help

```bash
git help config # 获取帮助信息
```

### add

```shell
git add * # 跟踪新文件
git add -u [path] # 添加[指定路径下]已跟踪文件
```

### rm

```shell
rm *&git rm * # 移除文件
git rm -f * # 移除文件
git rm --cached * # 取消跟踪
git mv file_from file_to # 重命名跟踪文件
git log # 查看提交记录
```

### commit

```shell
git commit #提交更新
git commit -m 'message' #提交说明
git commit -a #跳过使用暂存区域，把所有已经跟踪过的文件暂存起来一并提交
git commit --amend #修改最后一次提交
git commit log #查看所有提交，包括没有push的commit
git commit -m "#133" #关联issue 任意位置带上# 符号加上issue号码
git commit -m "fix #133" commit关闭issue
git commit -m '概要描述'$'\n\n''1.详细描述'$'\n''2.详细描述' #提交简要描述和详细描述
```

### reset

```shell
git reset HEAD * # 取消已经暂存的文件
git reset --mixed HEAD * # 同上
git reset --soft HEAD * # 重置到指定状态，不会修改索引区和工作树
git reset --hard HEAD * # 重置到指定状态，会修改索引区和工作树
git reset -- files * # 重置index区文件
```

### revert

```shell
git revert HEAD # 撤销前一次操作
git revert HEAD~ # 撤销前前一次操作
git revert commit # 撤销指定操作
```

### checkout

```shell
git checkout -- file # 取消对文件的修改（从暂存区——覆盖worktree file）
git checkout branch|tag|commit -- file_name # 从仓库取出file覆盖当前分支
git checkout HEAD~1 [文件] # 将会更新 working directory 去匹配某次 commit
git checkout -- . # 从暂存区取出文件覆盖工作区
git checkout -b gh-pages 0c304c9 # 这个表示从当前分支 commit 哈希值为 0c304c9 的节点，分一个新的分支gh-pages出来，并切换到 gh-pages
```

### diff

```shell
git diff file # 查看指定文件的差异
git diff --stat # 查看简单的diff结果
git diff # 比较 Worktree 和 Index 之间的差异
git diff --cached # 比较Index和HEAD之间的差异
git diff HEAD # 比较Worktree和HEAD之间的差异
git diff branch # 比较Worktree和branch之间的差异
git diff branch1 branch2 # 比较两次分支之间的差异
git diff commit commit # 比较两次提交之间的差异
git diff master..test # 上面这条命令只显示两个分支间的差异
git diff master...test # 你想找出‘master’,‘test’的共有父分支和'test'分支之间的差异，你用3个‘.'来取代前面的两个'.'
```

### stash

存储当前的修改，但不用提交 commit

```shell
git stash # 将工作区现场（已跟踪文件）储藏起来，等以后恢复后继续工作。
git stash -u # 保存当前状态，包括 untracked 的文件
git stash list # 查看保存的工作现场
git stash apply # 恢复工作现场
git stash drop # 删除stash内容
git stash clear # 删除所有的 stash
git stash pop # 恢复的同时直接删除stash内容
git stash apply stash@{0} # 恢复指定的工作现场，当你保存了不只一份工作现场时。
git checkout -- # 从 stash 中拿出某个文件的修改
```

### merge

```bash
git merge --squash test # 合并压缩，将test上的commit压缩为一条
```

### cherry-pick

```shell
git cherry-pick commit # 拣选合并，将commit合并到当前分支
git cherry-pick -n commit # 拣选多个提交，合并完后可以继续拣选下一个提交
```

### rebase

```shell
git rebase master # 将master分之上超前的提交，变基到当前分支
git rebase --onto master 169a6 # 限制回滚范围，rebase当前分支从169a6以后的提交
git rebase --interactive # 交互模式，修改commit
git rebase --continue # 处理完冲突继续合并
git rebase --skip # 跳过
git rebase --abort # 取消合并
```

## 分支branch

### 删除

```shell
git push origin :branchName # 删除远程分支
git push origin --delete new # 删除远程分支new
git branch -d branchName # 删除本地分支，强制删除用-D
git branch -d test # 删除本地test分支
git branch -D test # 强制删除本地test分支
git remote prune origin # 远程删除了，本地还能看到远程存在，这条命令删除远程不存在的分支
```

### 提交

```bash
git push -u origin branchName # 提交分支到远程origin主机中
```

### 拉取

```bash
git fetch -p # 拉取远程分支时，自动清理远程分支已删除，本地还存在的对应同名分支。
git fetch origin '+refs/heads/*:refs/heads/*' # 更新所有分支内容
```

### 分支合并

```shell
git merge branchName # 合并分支 - 将分支branchName和当前所在分支合并
git merge origin/master # 在本地分支上合并远程分支。
git rebase origin/master # 在本地分支上合并远程分支。
git merge test # 将test分支合并到当前分支
```

### 重命名

```bash
git branch -m old new # 重命名分支
```

### 查看

```shell
git branch # 列出本地分支
git branch -r # 列出远端分支
git branch -a # 列出所有分支
git branch -v # 查看各个分支最后一个提交对象的信息
git branch --merge # 查看已经合并到当前分支的分支
git branch --no-merge # 查看为合并到当前分支的分支
git remote show origin # 可以查看remote地址，远程分支
```

### 新建

```shell
git branch test # 新建test分支
git branch newBrach 3defc69 # 指定哈希3defc69，新建分支名字为newBrach
git checkout -b newBrach origin/master # 取回远程主机的更新以后，在它的基础上创建一个新的分支
git checkout -b newBrach 3defc69 # 以哈希值3defc69，新建 newBrach 分支，并切换到该分支
```

### 连接

```shell
git branch --set-upstream dev origin/dev # 将本地dev分支与远程dev分支之间建立链接
git branch --set-upstream master origin/next # 手动建立追踪关系
```

### 分支切换

```shell
git checkout - # 快速切换分支上一个分支
git checkout test # 切换到test分支
git checkout -b test # 新建+切换到test分支
git checkout -b test dev # 基于dev新建test分支，并切换
```

## 远端

```shell
git fetch <远程主机名> <分支名> # fetch取回所有分支（branch）的更新
git fetch origin remotebranch[:localbranch] # 从远端拉去分支[到本地指定分支]
git merge origin/branch # 合并远端上指定分支
git pull origin remotebranch:localbranch # 拉去远端分支到本地分支
git push origin branch # 将当前分支，推送到远端上指定分支
git push origin localbranch:remotebranch # 推送本地指定分支，到远端上指定分支
git push origin :remotebranch # 删除远端指定分支
git checkout -b [--track] test origin/dev # 基于远端dev分支，新建本地test分支[同时设置跟踪]
```

## submodule

克隆项目同时克隆 submodule

```bash
git clone https://github.com/jaywcjlove/handbook.git --depth=1 --recurse-submodules
```

克隆项目，之后再手动克隆 submodule 子项目

```bash
git submodule add -b gh-pages --force '仓库地址' '路径'
git submodule add --force '仓库地址' '路径'
# 其中，仓库地址是指子模块仓库地址，路径指将子模块放置在当前工程下的路径。
# 注意：路径不能以 / 结尾（会造成修改不生效）、不能是现有工程已有的目录（不能順利 Clone）
git submodule init # 初始化 submodule
git submodule update # 更新submodule(必须在根目录执行命令)
git submodule update --init --recursive # 下载的工程带有submodule
git submodule update --recursive --remote # 对于 git 1.8.2 或更高版本，添加了选项 --remote 以支持更新远程分支
git pull --recurse-submodules # 更新 submodule git 1.7.3 版本
```

当使用`git clone`下来的工程中带有submodule时，初始的时候，submodule的内容并不会自动下载下来的，此时，只需执行如下命令：

```bash
git submodule foreach --recursive git submodule init
```

### 更新 submodule

```bash
git submodule foreach git pull # submodule 里有其他的 submodule 一次更新
git submodule foreach git pull origin master # submodule更新
git submodule foreach --recursive git submodule update
git submodule update --recursive --remote
git pull --recurse-submodules
git submodule deinit --all -f # 清理 submodule
```

```bash
git clone --recurse-submodules --depth=1 --shallow-submodules https://github.com/example/project.git
# --depth 选项限制拉取历史记录的数量，以减少克隆所需的时间和空间
# --shallow-submodules 则限制子模块拉取的历史记录数量，这两者的结合可以在 Git 项目中只拉取代码
```

### 删除 submodule

```bash
git ls-files --stage <子项目名称路径> # 查看子项目
vim .gitmodules # 删除对应的 submodule
vim .git/config # 删除对应的 submodule
git rm --cached <子模块名称> # 删除缓存中的子项目，注意没有 `/`
git rm --cached subProjectName
rm -rf project/subProjectName
rm .git/module/* # 删除模块下的子模块目录，每个子模块对应一个目录，注意只删除对应的子模块目录即可
```

### 转换分支

```bash
$ git config -f .gitmodules submodule.public.branch gh-pages
```

下面是更改 `.gitmodules` 文件内容

```
[submodule "public"]
path = public
url = [email protected]:jaywcjlove/gitke.git
branch = gh-pages
```

## 删除文件

```bash
git rm -rf node_modules/
```

## remote

git是一个分布式代码管理工具，所以可以支持多个仓库，在git里，服务器上的仓库在本地称之为remote。个人开发时，多源用的可能不多，但多源其实非常有用。

```shell
git remote add origin1 [email protected]:yanhaijing/data.js.git
git remote # 显示全部源
git remote -v # 显示全部源+详细信息
git remote rename origin1 origin2 # 重命名
git remote rm origin # 删除
git remote show origin # 查看指定源的全部信息
```

## 标签tag

当开发到一定阶段时，给程序打标签是非常棒的功能。

```bash
git tag -a v0.1.1 9fbc3d0 # 补打 tag，根据 hash 创建 tag
git tag -a v0.1 -m 'my version 1.4' # 新建带注释标签
git push origin --tags # 一次性推送所有分支
git push origin v1.5 # 推送单个tag到orgin源上
git tag -v v1.4.2.1 # 验证标签，验证已经签署的标签
git show v1.5 # 看到对应的 GPG 签

git tag # 列出现有标签
git tag v0gi.1 # 新建标签
git checkout tagname # 切换到标签
git tag -d v0.1 # 删除标签
git push origin :refs/tags/v0.1 # 删除远程标签
git pull --all # 获取远程所有内容包括tag
git --git-dir='<绝对地址>/.git' describe --tags HEAD # 查看本地版本信息
```

### 重命名Tag

```bash
mv .git/refs/tags/1.9.1 .git/refs/tags/v1.9.1
git push -f --tags
```

## 日志log

```bash
git config --global format.pretty "%Cgreen%h%Creset %s %Cblue@%cn%Creset %Cred%ai%Creset" # 全局配置彩色 log 输出
git config --global format.pretty "%h: %s @%cn %ai" # 全局配置格式化后的 log
git config format.pretty oneline # 显示历史记录时，每个提交的信息只显示一行
git config color.ui true # 彩色的 git 输出
git log # 查看最近的提交日志
git log --grep=224 # 这条命令是查看含有 "224" 关键字的 git commit
git log --pretty=oneline # 单行显示提交日志
git log --graph --pretty=oneline --abbrev-commit
git log -num # 显示第几条log（倒数）
git reflog # 查看所有分支的所有操作记录
git log --since=1.day # 一天内的提交；你可以给出各种时间格式，比如说具体的某一天（“2008-01-15”），或者是多久以前（“2 years 1 day 3 minutes ago”）。
git log --pretty="%h - %s" --author=自己的名字 # 查看自己的日志
git log -p -2 # 展开两次更新显示每次提交的内容差异
git log --stat # 要快速浏览其他协作者提交的更新都作了哪些改动
git log --pretty=format:"%h - %an, %ar : %s"# 定制要显示的记录格式
git log --pretty=format:'%h : %s' --date-order --graph # 拓扑顺序展示
git log --pretty=format:'%h : %s - %ad' --date=short # 日期YYYY-MM-DD显示
git log --pretty=oneline --graph --decorate --all # 展示简化的 commit 历史
git log HEAD --pretty=format:%s # 只显示commit
git config --global format.pretty '%h : %s - %ad' --date=short #日期YYYY-MM-DD显示写入全局配置
```

|选项 | 说明|选项 | 说明|
|----|----|----|----|
|%H |提交对象（commit）的完整哈希字串 |%ad |作者修订日期（可以用 -date= 选项定制格式）|
|%h |提交对象的简短哈希字串 |%ar |作者修订日期，按多久以前的方式显示|
|%T |树对象（tree）的完整哈希字串 |%cn |提交者(committer)的名字|
|%t |树对象的简短哈希字串 |%ce |提交者的电子邮件地址|
|%P |父对象（parent）的完整哈希字串 |%cd |提交日期|
|%p |父对象的简短哈希字串 |%cr |提交日期，按多久以前的方式显示|
|%an |作者（author）的名字 |%s |提交说明|
|%ae |作者的电子邮件地址| - | - |

[Pretty Formats](https://git-scm.com/docs/git-log#_pretty_formats)

## 重写历史

```bash
git commit --amend # 改变最近一次提交
git rebase -i HEAD~3 # 修改最近三次的提交说明，或者其中任意一次
git commit --amend # 保存好了，这些指示很明确地告诉了你该干什么
git rebase --continue # 修改提交说明，退出编辑器。
```

```bash
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
```

## 其它

```bash
git help * # 获取命令的帮助信息
git status # 获取当前的状态，非常有用，因为git会提示接下来的能做的操作
```

## 报错问题解决

**1. `git fatal: protocol error: bad line length character: No s`**

解决办法：更换remote地址为 `http/https` 的

**2. `The requested URL returned error: 403 Forbidden while accessing`**

解决github push错误的办法：

```shell
#vim 编辑器打开当前项目中的config文件
vim .git/config

#修改
[remote "origin"]
url = https://github.com/jaywcjlove/example.git

#为下面代码
[remote "origin"]
url = https://[email protected]/jaywcjlove/example.git
```

**3. git status 显示中文问题**

在查看状态的时候 git status 如果是中文就显示下面的情况

```bash
\344\272\247\345\223\201\351\234\200\346\261\202
```

解决这个问题方法是：

```bash
git config --global core.quotepath false
```

**4. The authenticity of host 192.168.0.xxx can't be establis**

修改 `/etc/ssh/ssh_config` 中的 `StrictHostKeyChecking` 的 `ask` 为 `no` 解决问题。

**5. SSH连接时出现 Host key verification failed 的原因及解决方法**

用 OpenSSH 的人都知 ssh 会把你每个你访问过计算机的公钥(public key)都记录在~/.ssh/known_hosts。当下次访问相同计算机时，OpenSSH 会核对公钥。如果公钥不同，OpenSSH 会发出警告，避免你受到 DNS Hijack 之类的攻击。
SSH 对主机的 public_key 的检查等级是根据

```bash
StrictHostKeyChecking=no # 最不安全的级别，当然也没有那么多烦人的提示了，相对安全的内网测试时建议使用。如果连接server的key在本地不存在，那么就自动添加到文件中（默认是known_hosts），并且给出一个警告。
StrictHostKeyChecking=ask # 默认的级别，就是出现刚才的提示了。如果连接和key不匹配，给出提示，并拒绝登录。
StrictHostKeyChecking=yes # 最安全的级别，如果连接与key不匹配，就拒绝连接，不会提示详细信息。
```

【解决方法1】在 `.ssh/config`（或者`/etc/ssh/ssh_config`）中配置：

```conf
StrictHostKeyChecking no
UserKnownHostsFile /dev/null
```

解决方法 2

```bash
vi ~/.ssh/known_hosts # 删除对应ip的相关rsa信息
rm known_hosts # 或者直接全部删除
```

**5. insufficient permission for adding an object to repository database .git/objects**

```
cd .git/objects
ls -al
sudo chown -R yourname:yourgroup *
```

## 参考资料

- [Git官网](http://git-scm.com/)
- [**Github 15分钟学习Git**](https://try.github.io)
- [Git参考手册](http://gitref.org/zh/index.html)
- [Git简明手册](http://www.mceiba.com/tool/git-cheat-sheet.html)
- [Git Magic](http://www-cs-students.stanford.edu/~blynn/gitmagic/intl/zh_cn/)
- [Git Community Book 中文版](http://gitbook.liuhui998.com/index.html)
- [Pro Git](http://git-scm.com/book/en/v2)
- [图解Git](http://marklodato.github.io/visual-git-guide/index-zh-cn.html)
- [git-简明指南](http://rogerdudler.github.io/git-guide/index.zh.html)
- [learnGitBranching 在线学习工具](http://pcottle.github.io/learnGitBranching/)
- [初级教程](http://rogerdudler.github.io/git-guide/index.zh.html)
- [廖雪峰的Git教程](http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000)
- [蒋鑫老师将带你入github的大门](http://www.worldhello.net/gotgithub/)
- [git详解](http://www.open-open.com/lib/view/open1328069609436.html)
- [oschina教程](http://git.oschina.net/progit/)
- [How to undo (almost) anything with Git撤销一切，汇总各种回滚撤销的场景，加强学习。](https://github.com/blog/2019-how-to-undo-almost-anything-with-git)
- [Git 教程 | 菜鸟教程runoob.com](http://www.runoob.com/git/git-tutorial.html)
- [Git 本地仓库和裸仓库](https://gold.xitu.io/post/5842f9b861ff4b005889ade6)
- [沉浸式学 Git](http://www.kancloud.cn/kancloud/igit/46710)
- [Git进阶用法，主要是rebase高级用法](http://way.oschina.io/2016/12/15/notes/GitAdvance/?utm_source=gank.io&utm_medium=email)
- [成为一个git大师](https://www.atlassian.com/git/tutorials)
- [高质量的Git中文教程](https://github.com/geeeeeeeeek/git-recipes)

## Contributors

As always, thanks to our amazing contributors!

Made with [action-contributors](https://github.com/jaywcjlove/github-action-contributors).

## License