Git 进阶技巧！

Commit

如何设置 commit 中的姓名和 email？

git config --global user.name 'Dongyuan Liu'git config --global user.email 'liu.dongyuan@gmail.com'

如何以其他身份 commit？

git commit --author 'Xhacker <liu.dongyuan@gmail.com>'

或

GIT_COMMITTER_NAME='Xhacker' GIT_COMMITTER_EMAIL='liu.dongyuan@gmail.com' git commit --author 'Xhacker <liu.dongyuan@gmail.com>'

两者有什么区别呢？事实上，Git 中有两个关于作者的信息，committer 和 author。第一条命令将使用 Xhacker <liu.dongyuan@gmail.com> 作为 commit 的 author，第二条命令则同时设置 committer 和 author。

关于 committer 和 author 的区别，Pro Git 2.3 章 中提到：

你一定奇怪作者（author）和提交者（committer）之间究竟有何差别，其实作者指的是实际作出修改的人，提交者指的是最后将此工作成果提交到仓库的人。所以，当你为某个项目发布补丁，然后某个核心成员将你的补丁并入项目时，你就是作者，而那个核心成员就是提交者。我们会在第五章再详细介绍两者之间的细微差别。

如何针对每个 repo 单独设定姓名和 email？

有时，你可能想为不同的 repo（比如公司的项目和个人项目）设置不同的 committer 信息，很简单：

git config user.name 'Dongyuan Liu'git config user.email 'xhacker@ela.build'

可以看出，在使用 git config 时，默认修改的是当前 repo 的配置，如果添加 --global 则会修改全局的配置。

Commit message 应该怎么写？

Commit message 应简短、清晰地描述这个 commit 中做了什么。如果所有协作者都能阅读中文，则可以使用中文。若使用英文，请使用一般现在时。

正确示例：

Fix table view cell text overflow

修复了内存泄漏的问题

错误示例：

fixed some bugs

修改文件

同时，如果你使用 GitHub 管理代码，还可以通过 commit message 关闭 issue（官方说明），比如：

[Close #40] Send Dribbble shots from XPC service in batches

如何将修改追加到上一个 commit？

假设你发现刚刚完成的 commit 中有一处错误，你一定希望把修改追加到上一个 commit 中，而不是创建一个新的 commit。很简单，只需要用 --amend：

git commit --amend

在 amend 之后，commit 的时间是不会变的。如果你想更新一下 commit 时间，可以用

git commit --amend --reset-author

需要注意的是，amend 实际上修改了上一个 commit。所以如果已经 push 了上一个 commit，请尽量不要 amend。

如果一定要 amend 已经 push 了的 commit，请确保这个 commit 所在的 branch 只有你一个人使用（否则会给其他人带来灾难），然后在 amend 之后使用 git push --force。

如何 commit 文件的一部分？

git commit -p

之后，Git 会对每块修改弹出一个提示，询问你是否 stage：

diff --git a/Source/Player.swift b/Source/Player.swift
index af1cb7f..6ee0213 100644
--- a/Source/Player.swift
+++ b/Source/Player.swift@@ -323,9 +323,7 @@ public class Player: UIViewController {
     }
 
     private func setupPlayerItem(playerItem: AVPlayerItem?) {
     -        let item = playerItem
     -
     -        if item == nil {
     +        if self.playerItem != nil {
             self.playerItem?.removeObserver(self, forKeyPath: PlayerEmptyBufferKey, context: &PlayerItemObserverContext)
             self.playerItem?.removeObserver(self, forKeyPath: PlayerKeepUp, context: &PlayerItemObserverContext)
             self.playerItem?.removeObserver(self, forKeyPath: PlayerStatusKey, context: &PlayerItemObserverContext)
Stage this hunk [y,n,q,a,d,/,j,J,g,e,?]?

按 y/n 来选择是否 commit 这块修改，? 可以查看其他操作的说明。

什么是 stage？

在 Git 中，有一个 staging area 的概念，你可以理解为一个暂存区。在运行 git commit 时，只有在 staging area 里的修改会被 commit。在工程量比较大时，staging area 可以帮助你提交一部分修改。通过 git add <filename> 可以 stage 一个文件；git add -p 可以 stage 文件的一部分，用法和之前介绍的 git commit -p 类似。

如何查看当前修改了哪些文件？

通过 git status，你可以查看所有未提交文件的状态。最上面显示的是在 staging area，即将被 commit 的文件；中间显示没有 stage 的修改了的文件，最下面是新的还没有被 Git track 的文件：

On branch fix-kvo-crash
Your branch is behind 'origin/fix-kvo-crash' by 1 commit, and can be fast-forwarded.
  (use 'git pull' to update your local branch)
Changes to be committed:
  (use 'git reset HEAD <file>...' to unstage)

    modified:   Source/InboardHelper.swift

Changes not staged for commit:
  (use 'git add <file>...' to update what will be committed)
  (use 'git checkout -- <file>...' to discard changes in working directory)

    modified:   Source/InboardHelperDelegate.swift

Untracked files:
  (use 'git add <file>...' to include in what will be committed)

    SyncManager.swift

git diff 可以查看当前没有 stage 的修改，git diff --staged 可以查看在 staging area 中的修改。

如何查看某个特定的 commit 修改了哪些文件？

要查看某个 commit 的修改，可以用 git show：

# 查看最后一个 commit 的修改git show# 查看倒数第三个 commit 的修改git show HEAD~3# 查看 hash 为 deadbeef 的 commit 的修改git show deadbeef

HEAD~3 是什么意思？

HEAD 是指向当前顶部 commit 的指针，HEAD~3 就是向前数三个的 commit，即倒数第四个 commit。

Commit 的 hash 到底有多长？

Git commit 的 hash 是对 commit 内容的 SHA-1 checksum，通常用 40 位 16 进制数表示，比如 a502950cd563f2ed210d6610bf5d82f72827ea19。然而，只要没有冲突，你通常可以用一个比较短的前缀来表示一个 commit。比如 git show a50295，git checkout a50295。

如何 push 一部分 commit？

有时你在本地做了很多个 commit，却只想 push 其中的前几个，这时只要：

git push <remotename> <commit SHA>:<remotebranchname># push 9790eff 之前的所有 commit 到 mastergit push origin 9790eff:master

如何 commit 一个空目录？

Git 本身不支持 track 空目录。然而，你可以建一个空的隐藏文件来解决这个问题。比如，要想 commit 一个空的 output 目录，可以：

mkdir output
touch output/.keep
git add output/.keep

如何忽略文件？

在项目根目录建立 .gitignore 可以忽略文件：

# 忽略所有名为 .DS_Store 的文件.DS_Store# 忽略所有扩展名为 .o 的文件*.o

.gitignore 中还支持很多其他语法，具体可以参见 gitignore 文档。

什么文件应该忽略，什么文件不应该？

一般来说，临时文件和后期生成的文件应该忽略掉。比如 OS X 上的 .DS_Store、Windows 上的 Thumbs.db、C 语言项目中的 *.o 等等。在 GitHub 新建项目时，可以选择自动添加合适的 .gitignore。

如何仅在本地忽略文件？

有时你想忽略一些自己的文件，却不想污染 repo 中的 .gitignore，也可以修改 .git/info/exclude 文件。语法和 .gitignore 一样。

Branch

如何新建 branch？

以下两种方式可以新建 branch：

# 新建 branchgit branch <branchname># 新建并切换至该 branch（比较常用）git checkout -b <branchname>

如何删除 branch？

git branch -d <branchname>

如何切换到上一个 branch？

git checkout <branchname># 切换到上一个 branchgit checkout -

是不是和 cd - 有点像？

到底什么是 branch？什么又是 HEAD？

Branch 的实质是指向某个 commit 的指针。HEAD 的实质也是一个指针，指向当前工作目录所处的 commit。所以，git checkout <branchname> 做的事情就是让 HEAD 指向 branchname。

如何应用其他 branch 的某个 commit？

假如你在某个 branch 做了一大堆 commit，而在另一个 branch 想应用其中的一个，可以：

git cherry-pick <commit SHA>

如何 merge 一个 branch？

你在一个 feature branch 上实现了一些功能，想合并回主分支时：

# 确保当前处于主分支git checkout master# 合并 feature branch，禁止 fast forwardgit merge --no-ff <feature branch>

什么是 fast forward？

merge 和 rebase 有什么区别？

如何查看所有已经被 merge 的 branch？如何删除它们？

# 显示所有已经被 merge 的 branch
git branch --merged
# 显示所有还没被 merge 的 branch
git branch --no-merged
# 删除所有已经被 merge 的 branch
git branch --merged | xargs git branch -d

后悔药

如何重置某个文件到未修改的状态？

git checkout -- <filepath>

如何重置所有文件到未修改的状态？

git reset --hard

如何重置到某个 commit？

git reset <commit SHA>

比如，如果希望将当前 branch 重置为倒数第二个 commit（即丢弃最后一个 commit）：

git reset HEAD~1

git reset 有三个参数可以选择，--soft、--mixed和--hard。（TODO）

如何删除所有新增的文件？

如何还原某个 commit？

git revert <commit SHA>

你可能会问，还原和重置有什么区别？还原（revert）的实质是产生一个新的 commit，内容和要还原的 commit 完全相反。比如，A commit 在 main.c 中增加了三行，revert A 产生的 commit 就会删除这三行。如果我们非常确定之前的某个 commit 产生了 bug，最好的办法就是 revert 它。

git revert 后 git 会提示你写一些 commit message，此处最好简单描述为什么要还原，比如：

Revert 'Use DDT to kill insects' because it has so many side effects

This reverts commit 4281ac1c58e21194b80a327af93d47c5fefb786f.

而重置（reset）会修改历史，常用于还没有 push 的本地 commits。

如何修改最后一个 commit？

git reset --soft

如何删除某个 commit？如何修改某个 commit 的 message？如何变换两个 commit 的顺序？如何把一个 commit 拆成多个？如何追加内容到以前的 commit？

删除和还原有什么区别？

git rebase -i master
git rebase -i 22e21f2
git rebase -i HEAD~3

[more explaination]

already pushed? mention git push -f

我把一个 commit 彻底删掉了，还能恢复吗？

git reflog
git log HEAD@{6}\n: 1415211713:0;git log HEAD@{6}
git reflog HEAD@{6}
git reset --hard HEAD@{6}

协作与 GitHub

别人 push 了修改，我无法 push 了，怎么办？

git fetch
git rebase origin/master

如何用 commit 关闭 GitHub issue？

GitHub 支持通过 commit 自动关闭 issue。你只需在 commit message 中包含 close、fix 等字样即可，详见 Closing issues via commit messages。

比如以下两条都可以关闭 42 号 issue：

[Fix #42] Fix table view cell text overflow

Fix table view cell text overflow, close #42

如何给开源项目提交 pull request？

如何跟进开源项目上游的更改？

黑魔法

发现了一个 bug，如何知道是哪个 commit 导致的？

git bisect

如何让 Git 的命令更短？

.gitconfig .zshrc

如何在 shell 中更好地使用 Git？

附录

好用的 Git GUI 客户端

关于 CLI 和 GUI 哪个好有很多争论。我的观点是，对于 Git 来说，一个好用的 GUI 客户端配合 CLI 是最为高效的。在 push 之前，一个好习惯是仔细检查 commit 的内容，而图形界面能让你清晰地看到所有修改。再如如果你想 commit 文件的一部分，用客户端也比 git add -p 直观不少。

• GitHub Desktop（免费）：支持 Mac 和 Windows。强烈推荐，功能不多，但设计非常合理。

• SourceTree（免费）：支持 Mac 和 Windows，功能丰富。如果觉得 GitHub 客户端不够用可以试试。我觉得 UI 有点乱。

• Tower（收费）：支持 Mac。我现在正在用的客户端。虽然比较贵，但是功能丰富且非常顺手。

.gitconfig

[alias]
    co = checkout    
    st = status    
    lg = log --pretty=format:\'%h