[
  {
    "path": ".gitignore",
    "content": "# osx\n.DS_Store\n\n# vscode\n.vscode\n"
  },
  {
    "path": "README.md",
    "content": "# Git 的奇技淫巧:see_no_evil:\n\n> Git 常用命令集合，Fork 自 [tips](https://github.com/git-tips/tips) 项目\n\nGit 是一个分布式版本管理工具，版本管理工具就是大家在写东西的时候都用过 **回撤**这个功能，但是回撤只能回撤几步，假如想要找回我三天之前的修改，光用回撤是找不回来的。而**版本管理工具能记录每次的修改**，只要提交到版本仓库，就可以找到之前任何时刻的状态（文本状态）。\n\n下面的内容就是列举了常用的 Git 命令和一些小技巧，可以通过页面内查找的方式 `Ctrl/Command+f` 进行快速查找。\n\n## 开卷必读\n\n*如果之前未使用过 Git，可以学习 [Git 小白教程](https://rogerdudler.github.io/git-guide/index.zh.html)入门*\n\n1. **一定要先测试命令的效果后**，再用于工作环境中，以防造成不能弥补的后果！**到时候别拿着砍刀来找我**\n2. 所有的命令都在 `git version 2.7.4 (Apple Git-66)` 下测试通过\n3. 统一概念：\n\t- 工作区：改动（增删文件和内容）\n\t- 暂存区：输入命令：`git add 改动的文件名`，此次改动就放到了 ‘暂存区’\n\t- 本地仓库(简称：本地)：输入命令：`git commit 此次修改的描述`，此次改动就放到了本地仓库，每个 commit，我叫它为一个版本。\n\t- 远程仓库(简称：远程)：输入命令：`git push 远程仓库`，此次改动就放到了远程仓库（GitHub 等)\n\t- commit-id：输出命令：`git log`，最上面那行 `commit xxxxxx`，后面的字符串就是 commit-id\n4. 如果喜欢这个项目，欢迎 Star、提交 Pr、[反馈问题](https://github.com/521xueweihan/git-tips/issues)😊\n\n## 目录\n* [脑图](#脑图)\n* [展示帮助信息](#展示帮助信息)\n* [回到远程仓库的状态](#回到远程仓库的状态)\n* [重设第一个commit](#重设第一个-commit)\n* [查看冲突文件列表](#查看冲突文件列表)\n* [展示工作区和暂存区的不同](#展示工作区和暂存区的不同)\n* [展示暂存区和最近版本的不同](#展示暂存区和最近版本的不同)\n* [展示暂存区、工作区和最近版本的不同](#展示暂存区工作区和最近版本的不同)\n* [快速切换到上一个分支](#快速切换到上一个分支)\n* [删除已经合并到 master 的分支](#删除已经合并到-master-的分支)\n* [展示本地分支关联远程仓库的情况](#展示本地分支关联远程仓库的情况)\n* [关联远程分支](#关联远程分支)\n* [列出所有远程分支](#列出所有远程分支)\n* [列出本地和远程分支](#列出本地和远程分支)\n* [查看远程分支和本地分支的对应关系](#查看远程分支和本地分支的对应关系)\n* [远程删除了分支本地也想删除](#远程删除了分支本地也想删除)\n* [创建并切换到本地分支](#创建并切换到本地分支)\n* [从远程分支中创建并切换到本地分支](#从远程分支中创建并切换到本地分支)\n* [删除本地分支](#删除本地分支)\n* [删除远程分支](#删除远程分支)\n* [重命名本地分支](#重命名本地分支)\n* [查看标签](#查看标签)\n* [查看标签详细信息](#查看标签详细信息)\n* [本地创建标签](#本地创建标签)\n* [推送标签到远程仓库](#推送标签到远程仓库)\n* [删除本地标签](#删除本地标签)\n* [删除远程标签](#删除远程标签)\n* [切回到某个标签](#切回到某个标签)\n* [放弃工作区的修改](#放弃工作区的修改)\n* [恢复删除的文件](#恢复删除的文件)\n* [以新增一个 commit 的方式还原某一个 commit 的修改](#以新增一个-commit-的方式还原某一个-commit-的修改)\n* [回到某个 commit 的状态，并删除后面的 commit](#回到某个-commit-的状态并删除后面的-commit)\n* [修改上一个 commit 的描述](#修改上一个-commit-的描述)\n* [查看 commit 历史](#查看-commit-历史)\n* [显示本地更新过 HEAD 的 git 命令记录](#显示本地更新过-head-的-git-命令记录)\n* [修改作者名](#修改作者名)\n* [修改远程仓库的 url](#修改远程仓库的-url)\n* [增加远程仓库](#增加远程仓库)\n* [列出所有远程仓库](#列出所有远程仓库)\n* [查看两个星期内的改动](#查看两个星期内的改动)\n* [把 A 分支的某一个 commit，放到 B 分支上](#把-A-分支的某一个-commit放到-B-分支上)\n* [给 git 命令起别名](#给-git-命令起别名)\n* [存储当前的修改，但不用提交 commit](#存储当前的修改但不用提交-commit)\n* [保存当前状态，包括 untracked 的文件](#保存当前状态包括-untracked-的文件)\n* [展示所有 stashes](#展示所有-stashes)\n* [回到某个 stash 的状态](#回到某个-stash-的状态)\n* [回到最后一个 stash 的状态，并删除这个 stash](#回到最后一个-stash-的状态并删除这个-stash)\n* [删除所有的 stash](#删除所有的-stash)\n* [从 stash 中拿出某个文件的修改](#从-stash-中拿出某个文件的修改)\n* [展示所有 tracked 的文件](#展示所有-tracked-的文件)\n* [展示所有 untracked 的文件](#展示所有-untracked-的文件)\n* [展示所有忽略的文件](#展示所有忽略的文件)\n* [强制删除 untracked 的文件](#强制删除-untracked-的文件)\n* [强制删除 untracked 的目录](#强制删除-untracked-的目录)\n* [展示简化的 commit 历史](#展示简化的-commit-历史)\n* [查看某段代码是谁写的](#查看某段代码是谁写的)\n* [把某一个分支导出成一个文件](#把某一个分支导出成一个文件)\n* [从包中导入分支](#从包中导入分支)\n* [执行 rebase 之前自动 stash](#执行-rebase-之前自动-stash)\n* [从远程仓库根据 ID，拉下某一状态，到本地分支](#从远程仓库根据-ID-拉下某一状态-到本地分支)\n* [详细展示一行中的修改](#详细展示一行中的修改)\n* [清除 `.gitignore` 文件中记录的文件](#清除-gitignore-文件中记录的文件)\n* [展示所有 alias 和 configs](#展示所有-alias-和-configs)\n* [展示忽略的文件](#展示忽略的文件)\n* [commit 历史中显示 Branch1 有的，但是 Branch2 没有 commit](#commit-历史中显示-Branch1-有的但是-Branch2-没有-commit)\n* [在 commit log 中显示 GPG 签名](#在-commit-log-中显示-GPG-签名)\n* [删除全局设置](#删除全局设置)\n* [新建并切换到新分支上，同时这个分支没有任何 commit](#新建并切换到新分支上同时这个分支没有任何-commit)\n* [展示任意分支某一文件的内容](#展示任意分支某一文件的内容)\n* [clone 下来指定的单一分支](#clone-下来指定的单一分支)\n* [clone 最新一次提交](#clone-最新一次提交)\n* [忽略某个文件的改动](#忽略某个文件的改动)\n* [忽略文件的权限变化](#忽略文件的权限变化)\n* [以最后提交的顺序列出所有 Git 分支](#以最后提交的顺序列出所有-Git-分支)\n* [在 commit log 中查找相关内容](#在-commit-log-中查找相关内容)\n* [把暂存区的指定 file 放到工作区中](#把暂存区的指定-file-放到工作区中)\n* [强制推送](#强制推送)\n* [git 配置 http 和 socks 代理](#git-配置-http-和-socks-代理)\n* [git 配置 ssh 代理](#git-配置-ssh-代理)\n* [优雅的Commit信息](#优雅的Commit信息)\n* [commit工具](#commit工具)\n* [声明](#声明)\n\n## 展示帮助信息\n```sh\ngit help -g\n```\nThe command output as below:\n\n```\nThe common Git guides are:\n   attributes          Defining attributes per path\n   cli                 Git command-line interface and conventions\n   core-tutorial       A Git core tutorial for developers\n   cvs-migration       Git for CVS users\n   diffcore            Tweaking diff output\n   everyday            A useful minimum set of commands for Everyday Git\n   glossary            A Git Glossary\n   hooks               Hooks used by Git\n   ignore              Specifies intentionally untracked files to ignore\n   modules             Defining submodule properties\n   namespaces          Git namespaces\n   repository-layout    Git Repository Layout\n   revisions           Specifying revisions and ranges for Git\n   tutorial            A tutorial introduction to Git\n   tutorial-2          A tutorial introduction to Git: part two\n   workflows           An overview of recommended workflows with Git\n\n'git help -a' and 'git help -g' list available subcommands and some concept guides. See 'git help <command>' or 'git help <concept>' to read about a specific subcommand or concept.\n```\n\n## 回到远程仓库的状态\n\n抛弃本地所有的修改，回到远程仓库的状态。\n```sh\ngit fetch --all && git reset --hard origin/master\n```\n\n## 重设第一个 commit\n\n也就是把所有的改动都重新放回工作区，并**清空所有的 commit**，这样就可以重新提交第一个 commit 了\n\n```sh\ngit update-ref -d HEAD\n```\n\n## 查看冲突文件列表\n\n展示工作区的冲突文件列表\n```sh\ngit diff --name-only --diff-filter=U\n```\n## 展示工作区和暂存区的不同\n\n输出**工作区**和**暂存区**的 different (不同)。\n\n```sh\ngit diff\n```\n\n还可以展示本地仓库中任意两个 commit 之间的文件变动：\n```sh\ngit diff <commit-id> <commit-id>\n```\n\n## 展示暂存区和最近版本的不同\n\n输出**暂存区**和本地最近的版本 (commit) 的 different (不同)。\n```sh\ngit diff --cached\n```\n\n## 展示暂存区、工作区和最近版本的不同\n\n输出**工作区**、**暂存区** 和本地最近的版本 (commit) 的 different (不同)。\n\n```sh\ngit diff HEAD\n```\n\n## 快速切换到上一个分支\n\n```sh\ngit checkout -\n```\n\n## 删除已经合并到 master 的分支\n\n```sh\ngit branch --merged master | grep -v '^\\*\\|  master' | xargs -n 1 git branch -d\n```\n\n## 展示本地分支关联远程仓库的情况\n```sh\ngit branch -vv\n```\n\n## 关联远程分支\n\n关联之后，`git branch -vv` 就可以展示关联的远程分支名了，同时推送到远程仓库直接：`git push`，不需要指定远程仓库了。\n```sh\ngit branch -u origin/mybranch\n```\n\n或者在 push 时加上 `-u` 参数\n```sh\ngit push origin/mybranch -u\n```\n\n## 列出所有远程分支\n\n-r 参数相当于：remote\n```sh\ngit branch -r\n```\n\n## 列出本地和远程分支\n\n-a 参数相当于：all\n```sh\ngit branch -a\n```\n\n## 查看远程分支和本地分支的对应关系\n\n```sh\ngit remote show origin\n```\n\n## 远程删除了分支本地也想删除\n\n```sh\ngit remote prune origin\n```\n\n## 创建并切换到本地分支\n```sh\ngit checkout -b <branch-name>\n```\n\n## 从远程分支中创建并切换到本地分支\n\n```sh\ngit checkout -b <branch-name> origin/<branch-name>\n```\n\n## 删除本地分支\n\n```sh\ngit branch -d <local-branchname>\n```\n\n## 删除远程分支\n\n```sh\ngit push origin --delete <remote-branchname>\n```\n\n或者\n\n```sh\ngit push origin :<remote-branchname>\n```\n\n## 重命名本地分支\n\n```sh\ngit branch -m <new-branch-name>\n```\n\n## 查看标签\n\n```sh\ngit tag\n```\n展示当前分支的最近的 tag\n\n```sh\ngit describe --tags --abbrev=0\n```\n\n## 查看标签详细信息\n\n```sh\ngit tag -ln\n```\n\n## 本地创建标签\n\n```sh\ngit tag <version-number>\n```\n\n默认 tag 是打在最近的一次 commit 上，如果需要指定 commit 打 tag：\n```sh\n$ git tag -a <version-number> -m \"v1.0 发布(描述)\" <commit-id>\n```\n\n## 推送标签到远程仓库\n\n首先要保证本地创建好了标签才可以推送标签到远程仓库：\n\n```sh\ngit push origin <local-version-number>\n```\n\n一次性推送所有标签，同步到远程仓库：\n\n```sh\ngit push origin --tags\n```\n\n## 删除本地标签\n\n```sh\ngit tag -d <tag-name>\n```\n\n## 删除远程标签\n\n```sh\ngit push origin --delete tag <tagname>\n```\n\n## 切回到某个标签\n\n一般上线之前都会打 tag，就是为了防止上线后出现问题，方便快速回退到上一版本。下面的命令是回到某一标签下的状态：\n```sh\ngit checkout -b branch_name tag_name\n```\n\n## 放弃工作区的修改\n```sh\ngit checkout <file-name>\n```\n\n放弃所有修改：\n```sh\ngit checkout .\n```\n\n## 恢复删除的文件\n```sh\ngit rev-list -n 1 HEAD -- <file_path> #得到 deleting_commit\n\ngit checkout <deleting_commit>^ -- <file_path> #回到删除文件 deleting_commit 之前的状态\n```\n\n## 以新增一个 commit 的方式还原某一个 commit 的修改\n\n```sh\ngit revert <commit-id>\n```\n\n## 回到某个 commit 的状态，并删除后面的 commit\n\n和 revert 的区别：reset 命令会抹去某个 commit id 之后的所有 commit\n\n```sh\ngit reset <commit-id>  #默认就是-mixed参数。\n\ngit reset --mixed HEAD^  #回退至上个版本，它将重置HEAD到另外一个commit,并且重置暂存区以便和HEAD相匹配，但是也到此为止。工作区不会被更改。\n\ngit reset --soft HEAD~3  #回退至三个版本之前，只回退了commit的信息，暂存区和工作区与回退之前保持一致。如果还要提交，直接commit即可  \n\ngit reset --hard <commit-id>  #彻底回退到指定commit-id的状态，暂存区和工作区也会变为指定commit-id版本的内容\n```\n\n## 修改上一个 commit 的描述\n\n如果暂存区有改动，同时也会将暂存区的改动提交到上一个 commit\n\n```sh\ngit commit --amend\n```\n\n## 查看 commit 历史\n```sh\ngit log\n```\n\n## 查看某段代码是谁写的\n\nblame 的意思为‘责怪’，你懂的。\n\n```sh\ngit blame <file-name>\n```\n\n## 显示本地更新过 HEAD 的 git 命令记录\n\n每次更新了 HEAD 的 git 命令比如 commit、amend、cherry-pick、reset、revert 等都会被记录下来（不限分支），就像 shell 的 history 一样。\n这样你可以 reset 到任何一次更新了 HEAD 的操作之后，而不仅仅是回到当前分支下的某个 commit 之后的状态。\n\n```sh\ngit reflog\n```\n\n## 修改作者名\n\n```sh\ngit commit --amend --author='Author Name <email@address.com>'\n```\n\n## 修改远程仓库的 url\n\n```sh\ngit remote set-url origin <URL>\n```\n\n## 增加远程仓库\n\n```sh\ngit remote add origin <remote-url>\n```\n\n## 列出所有远程仓库\n\n```sh\ngit remote\n```\n\n## 查看两个星期内的改动\n```sh\ngit whatchanged --since='2 weeks ago'\n```\n\n## 把 A 分支的某一个 commit，放到 B 分支上\n\n这个过程需要 `cherry-pick` 命令，[参考](http://sg552.iteye.com/blog/1300713#bc2367928)\n\n```sh\ngit checkout <branch-name> && git cherry-pick <commit-id>\n```\n\n## 给 git 命令起别名\n\n简化命令\n\n```sh\ngit config --global alias.<handle> <command>\n\n比如：git status 改成 git st，这样可以简化命令\n\ngit config --global alias.st status\n```\n\n## 存储当前的修改，但不用提交 commit\n\n详解可以参考[廖雪峰老师的 git 教程](http://www.liaoxuefeng.com/wiki/0013739516305929606dd18361248578c67b8067c8c017b000/00137602359178794d966923e5c4134bc8bf98dfb03aea3000)\n```sh\ngit stash\n```\n\n## 保存当前状态，包括 untracked 的文件\n\nuntracked 文件：新建的文件\n```sh\ngit stash -u\n```\n\n## 展示所有 stashes\n```sh\ngit stash list\n```\n\n## 回到某个 stash 的状态\n```sh\ngit stash apply <stash@{n}>\n```\n\n## 回到最后一个 stash 的状态，并删除这个 stash\n\n```sh\ngit stash pop\n```\n\n## 删除所有的 stash\n\n```sh\ngit stash clear\n```\n\n## 从 stash 中拿出某个文件的修改\n```sh\ngit checkout <stash@{n}> -- <file-path>\n```\n\n## 展示所有 tracked 的文件\n```sh\ngit ls-files -t\n```\n\n## 展示所有 untracked 的文件\n```sh\ngit ls-files --others\n```\n\n## 展示所有忽略的文件\n\n```sh\ngit ls-files --others -i --exclude-standard\n```\n\n## 强制删除 untracked 的文件\n\n可以用来删除新建的文件。如果不指定文件文件名，则清空所有工作的 untracked 文件。`clean` 命令，**注意两点**：\n1. clean 后，删除的文件无法找回\n2. 不会影响 tracked 的文件的改动，只会删除 untracked 的文件\n\n```sh\ngit clean <file-name> -f\n```\n\n## 强制删除 untracked 的目录\n\n可以用来删除新建的目录，**注意**:这个命令也可以用来删除 untracked 的文件。详情见上一条\n\n```sh\ngit clean <directory-name> -df\n```\n\n## 展示简化的 commit 历史\n```sh\ngit log --pretty=oneline --graph --decorate --all\n```\n\n## 把某一个分支导出成一个文件\n```sh\ngit bundle create <file> <branch-name>\n```\n\n## 从包中导入分支\n\n新建一个分支，分支内容就是上面 `git bundle create` 命令导出的内容\n\n```sh\ngit clone repo.bundle <repo-dir> -b <branch-name>\n```\n\n## 执行 rebase 之前自动 stash\n\n```sh\ngit rebase --autostash\n```\n\n## 从远程仓库根据 ID，拉下某一状态，到本地分支\n\n```sh\ngit fetch origin pull/<id>/head:<branch-name>\n```\n\n## 详细展示一行中的修改\n\n```sh\ngit diff --word-diff\n```\n\n## 清除 gitignore 文件中记录的文件\n\n```sh\ngit clean -X -f\n```\n\n## 展示所有 alias 和 configs\n\n**注意：** config 分为：当前目录（local）和全局（golbal）的 config，默认为当前目录的 config\n\n```sh\ngit config --local --list (当前目录)\ngit config --global --list (全局)\n```\n\n## 展示忽略的文件\n```sh\ngit status --ignored\n```\n\n## commit 历史中显示 Branch1 有的，但是 Branch2 没有 commit\n```sh\ngit log Branch1 ^Branch2\n```\n\n## 在 commit log 中显示 GPG 签名\n```sh\ngit log --show-signature\n```\n\n## 删除全局设置\n\n```sh\ngit config --global --unset <entry-name>\n```\n\n## 新建并切换到新分支上，同时这个分支没有任何 commit\n\n相当于保存修改，但是重写 commit 历史\n\n```sh\ngit checkout --orphan <branch-name>\n```\n\n## 展示任意分支某一文件的内容\n\n```sh\ngit show <branch-name>:<file-name>\n```\n\n## clone 下来指定的单一分支\n```sh\ngit clone -b <branch-name> --single-branch https://github.com/user/repo.git\n```\n\n## clone 最新一次提交\n\n只会 clone 最近一次提交，将减少 clone 时间\n\n```sh\ngit clone --depth=1 https://github.com/user/repo.git\n```\n\n## 忽略某个文件的改动\n\n关闭 track 指定文件的改动，也就是 Git 将不会在记录这个文件的改动\n\n```sh\ngit update-index --assume-unchanged path/to/file\n```\n\n恢复 track 指定文件的改动\n\n```sh\ngit update-index --no-assume-unchanged path/to/file\n```\n\n## 忽略文件的权限变化\n\n不再将文件的权限变化视作改动\n\n```sh\ngit config core.fileMode false\n```\n\n## 以最后提交的顺序列出所有 Git 分支\n\n最新的放在最上面\n\n```sh\ngit for-each-ref --sort=-committerdate --format='%(refname:short)' refs/heads/\n```\n\n## 在 commit log 中查找相关内容\n\n通过 grep 查找，given-text：所需要查找的字段\n\n\n```sh\ngit log --all --grep='<given-text>'\n```\n\n## 把暂存区的指定 file 放到工作区中\n\n不添加参数，默认是 `-mixed`\n\n```sh\ngit reset <file-name>\n```\n\n## 强制推送\n\n```sh\ngit push -f <remote-name> <branch-name>\n```\n\n## git 配置 http 和 socks 代理\n\n```sh\ngit config --global https.proxy 'http://127.0.0.1:8001'   # 适用于 privoxy 将 socks 协议转为 http 协议的 http 端口\ngit config --global http.proxy 'http://127.0.0.1:8001'\ngit config --global socks.proxy \"127.0.0.1:1080\"\n```\n\n## git 配置 ssh 代理\n\n```sh\n$ cat ~/.ssh/config\nHost gitlab.com\nProxyCommand nc -X 5 -x 127.0.0.1:1080 %h %p    # 直接使用 shadowsocks 提供的 socks5 代理端口\n\nHost github.com\nProxyCommand nc -X 5 -x 127.0.0.1:1080 %h %p    \n```\n\n\n## 脑图\n\n![](./assets/git.png)\n\n## 优雅的Commit信息\n\n使用[Angular团队提交规范](https://github.com/angular/angular.js/blob/master/DEVELOPERS.md#-git-commit-guidelines)\n\n主要有以下组成\n\n* 标题行: 必填, 描述主要修改类型和内容\n* 主题内容: 描述为什么修改, 做了什么样的修改, 以及开发的思路等等\n* 页脚注释: 放 Breaking Changes 或 Closed Issues\n\n常用的修改项\n\n* type: commit 的类型\n* feat: 新特性\n* fix: 修改问题\n* refactor: 代码重构\n* docs: 文档修改\n* style: 代码格式修改, 注意不是 css 修改\n* test: 测试用例修改\n* chore: 其他修改, 比如构建流程, 依赖管理.\n* scope: commit 影响的范围, 比如: route, component, utils, build...\n* subject: commit 的概述\n* body: commit 具体修改内容, 可以分为多行\n* footer: 一些备注, 通常是 BREAKING CHANGE 或修复的 bug 的链接.\n\n## commit工具\n\n可以使用[cz-cli](https://github.com/commitizen/cz-cli)工具代替 `git commit`\n\n全局安装\n\n```shell\nnpm install -g commitizen cz-conventional-changelog\n\necho '{ \"path\": \"cz-conventional-changelog\" }' > ~/.czrc\n```\n全局安装后使用 `git cz` 代替 `git commit`就可以了,如下图\n\n![](./assets/gitcz.png)\n\n\n## 声明\n<a rel=\"license\" href=\"https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh\"><img alt=\"知识共享许可协议\" style=\"border-width: 0\" src=\"https://licensebuttons.net/l/by-nc-nd/4.0/88x31.png\"></a><br>本作品采用 <a rel=\"license\" href=\"https://creativecommons.org/licenses/by-nc-nd/4.0/deed.zh\">署名-非商业性使用-禁止演绎 4.0 国际</a> 进行许可。\n\n**[⬆ 返回顶部](#目录)**\n"
  }
]