Git 操作文档

Git 是一个十分流行的版本控制系统，Git 和 SVN 区别在于，SVN使用增量文件系统，存储每次提交之间的差异。而 git 使用全量文件系统，存储每次提交的文件的全部内容(snapshot)。

git 保存的不是文件的变化或者差异，而是一系列不同时刻的文件快照。

安装

linux 下 git 安装很简单，apt-get 和 yum 直接装即可.

$ yum install -y git

配置

使用git config进行信息配置, 其实是针对 config 文件进行配置

$ cat config

[core]

        repositoryformatversion = 0

        ...

[remote "origin"]

        url = https://...

        fetch = +refs/heads/*:refs/remotes/origin/*

[branch "master"]

        remote = origin

        merge = refs/heads/master

若加上--global, 则是全局配置, 比如配置 [user] 域下的 name 和 email 信息。

$ git config --global user.name "bascker"

$ git config --global user.email "xxx@xx.com"

# 查看 git 配置信息

$ git config --list

别名

跟 linux 别名命令 alias 一样，git 也可以设置别名。

# 给 checkout 设置别名 ck，git ck 等价于 git checkout

$ git config --global alias.ck checkout

$ git config -l | grep alias

alias.ck=checkout

初始化仓库

使用git init可以创建一个 git 仓库。一般而言，纯粹用于版本控制的仓库，以 .git结尾。

# 初始化一个 git 仓库

$ git init sample.git

一般创建完仓库后，我们需要执行如下命令来允许 push 操作.

$ git config --gloabl receive.denyCurrentBranch ignore

# 若不执行, 可能会导致 push 失败, 报错

$ git push

remote: error: refusing to update checked out branch: refs/heads/master

remote: error: By default, updating the current branch in a non-bare repository

remote: error: is denied, because it will make the index and work tree inconsistent

remote: error: with what you pushed, and will require 'git reset --hard' to match

remote: error: the work tree to HEAD.

remote: error:

remote: error: You can set 'receive.denyCurrentBranch' configuration variable to

remote: error: 'ignore' or 'warn' in the remote repository to allow pushing into

remote: error: its current branch; however, this is not recommended unless you

remote: error: arranged to update its work tree to match what you pushed in some

remote: error: other way.

remote: error: To squelch this message and still keep the default behaviour, set

remote: error: 'receive.denyCurrentBranch' configuration variable to 'refuse'.

上面这个配置比较麻烦，可以在创建 git 仓库时一次性解决。使用如下命令即可。

# --shared 参数

$ git init --bare --shared sample.git

获取项目

git 支持 ssh/http(s)/ftp(s) 方式来获取远端代码. 通过git clone命令即可.

$ git clone https://USER_NAME:USER_PASS@IP/sample.git

命令选项:

-b: 获取指定分支，若不存在则报错
--depth: 获取代码的深度。若指定为 1，则只会获取到远程仓库的 master 分支

更新代码

最常用/基本操作，就是在本地进行代码/文本编辑后，提交代码入库.

# 跟踪当前目录下所有文件的变更

$ git add .

# 提交变更

$ git commit -m "描述信息"

# 推送到远端代码库

$ git push

对于 commit 而言, 注释最好以一行短句子(小于 50 个字符)作为开头, 然后空一行再把进行详细的注释,这样可以很方便的用工具把 commit 注释变成 email 通知，第一行作为标题，剩下的部分就作 email 正文.

分支管理

一般使用 git branch 和 git checkout 进行基础的分支管理操作.当然更进一步就是使用git merge/fetch/rebase命令了(这些命令的使用, 容后再议).

# 查看当前仓库的所有分支

$ git branch -a

* master

  remotes/origin/master

# 切换分支: -b 表示若无指定分支，则新建一个分支

$ git checkout -b bascker

Switch to a new branch 'bascker'

# 删除分支: 若使用 -D，则强制删除

$ git branch -d bascker

第一次 push 本地分支代码到远端时, 需要加 --set-upstream, 从而在远端创建一个分支.

$ git push --set-upstream origin bascker

git 分支本质就是指向提交对象（校验和文件）的指针，每次 commit，指针都会移动，指向最后一个 commit 对象。commit 流程图如下所示。

特殊 HEAD 指针，指向当前分支。若当前在 master 分支，则 HEAD 指向 master 分支。若在 bascker 分支，则指向 bascker。

# 使用 --decorate 查看分支各分支指针所指向的对象

$ git log --oneline --decorate

aa403d4 (HEAD -> master, bascker) add b2.txt

...

如上，HEAD 指向 master 分支，master & bascker 均执行 aa403d4 提交对象。

分支合并

当在分支 bascker 上进行开发后，想把代码合入主干 master，就可以执行合并操作 git merge.

# master 分支执行

$ git merge bascker

若出现冲突，则解决完冲突，在继续 merge.

Note：除第一次 commit 外，每次 commit 对象都会有一个父对象，多分支合并产生的 commit 对象有多个父对象。

查看状态

使用 git status 可以查看当前工作目录的状态，查看索引内容,哪些文件被暂存了(在Git索引中), 哪些文件被修改了但是没有暂存, 哪些文件没有被跟踪(untracked)。git 十分人性化的一点就在于每一个时间点，使用 git status 都有提示，告诉你下一步怎么做.

$ echo aaa > a.txt

$ git add a.txt

$ git status

On branch master

Your branch is up-to-date with 'origin/master'.

Changes to be committed:

  (use "git reset HEAD <file>..." to unstage)

        new file:   a.txt

Untracked files:

  (use "git add <file>..." to include in what will be committed)

        .idea/

查看历史

使用git log可以看到历史提交信息，搭配git show使用效果更佳.

$ git commit -m "add a.txt"

$ git log

commit 3da5d8691146288de84a466cbfb123fed5171329

Author: bascker <xxx@aliyun.com>

Date:   Sat May 26 22:16:15 2018 +0800

    add a.txt

# 查看 commit 对象信息

$ git show 3da5d8691146288de84a466cbfb123fed5171329

commit 3da5d8691146288de84a466cbfb123fed5171329

Author: bascker <jp2317015793@aliyun.com>

Date:   Sat May 26 22:16:15 2018 +0800

    add a.txt

diff --git a/a.txt b/a.txt

new file mode 100644

index 0000000..3c8969b

--- /dev/null

+++ b/a.txt

@@ -0,0 +1 @@

+aaa

# 使用 --oneline 可以将各个 commit 信息简单化

$ git log --oneline

aa403d4 add b2.txt

e4bf2fe add b1.txt

...

git show 用于查看 git 对象信息, 每一次提交都是一个 commit 对象，包括分支、tag 也是对象.

git log 常见选项

--stat: 显示在每个提交(commit)中哪些文件被修改了, 这些文件分别添加或删除了多少行内容
--pretty: 格式化日志输出
--graph: 图形化显示

标签管理

标签即 tag，通过git tag来进行标签管理，用于版本发布. 标签分为 2 种：

轻量标签：指向 commit 提交对象的引用
附注标签：生成独立的 tag 对象，拥有完整信息，建议使用

# 轻量标签

$ git tag v1.0.light

# 附注标签: 最简单方式就是使用 -a -m 参数

$ git tag -a v1.1 -m "附注标签"

$ git tag

v1.0.light

v1.1

# 查看标签对象

$ git show v1.1

Tagger: bascker <xxx@aliyun.com>

Date:   Sat May 26 22:31:35 2018 +0800

<E9><99><84><E6><B3><A8><E6><A0><87><E7><AD><BE>

commit 3da5d8691146288de84a466cbfb123fed5171329

Author: bascker <xxx@aliyun.com>

Date:   Sat May 26 22:16:15 2018 +0800

    add a.txt

diff --git a/a.txt b/a.txt

new file mode 100644

index 0000000..3c8969b

--- /dev/null

+++ b/a.txt

@@ -0,0 +1 @@

+aaa

# 使用 git checkout 可以切换到指定标签

$ git checkout v1.1

变基操作

一般都是使用git merge进行分支合并, 但还有一种更棒的方式就是git rebase变基操作.所谓变基，就是变更基线.

如图所示，我们基于 master 创建了 merge 和 rebase 分支, 在 merge 和 rebase 分支上分别前进了 2 次, 与此同时, master 也前进了, 这时候我们分别在 merge 分支执行 git merge master 和在 rebasr 分支执行 git rebase master 利用 gitk 查看结果，可以看到 rebase 操作的分支历史比 merge 干净整洁很多.

Note: gitk 是一个以图形的方式显示项目历史的命令

$ git rebase master

First, rewinding head to replay your work on top of it...

Applying: add r1.txt

Applying: add r2.txt

git rebase 操作会将本地的提交历史，由远及近逐一跟 master 进行合并。若发送冲突，则需要我们手工解决冲突后，执行 git rebase --continue 继续之前的操作即可.

git rebase 还拥有将多个 commit 合并成一个 commit 的逆天功能，这个功能十分有用.

# 将前 2 次提交进行 rebase

$ git rebase -i HEAD~2

这样就会进入命令模式, 然后根据提示进行操作即可

pick f8f5714 add b1.txt

pick aea2a1b add b2.txt

# Rebase ba6bea9..aea2a1b onto ba6bea9 (2 command(s))

#

# 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

#

# These lines can be re-ordered; they are executed from top to bottom.

#

# If you remove a line here THAT COMMIT WILL BE LOST.

#

# However, if you remove everything, the rebase will be aborted.

#

# Note that empty commits are commented out

暂存变更

有时候我们还未开发代码完毕，需要切到其他分支，但又不想执行 commit 提交变更时，可通过git stash命令来暂存变更.

$ echo ccc > c.txt

$ git stash				# 暂存变更

$ git stash list

stash@{0}: WIP on bascker: aea2a1b add b2.txt

# 切换到其他分支, 执行某些操作

$ git checkout master

$ ...

# 切换回后，取回缓存

$ git stash pop

# 再执行 git stash list 显示没有暂存了

获取指定分支代码

有时候我们需要获取指定分支的代码，怎么办呢？可以通过git fetch & git checkout 来实现.

# 1.fetch 指定分支到本地

$ git fetch origin ORIGIN_BRANCE_NAME

# 2.将远程分支映射到本地

$ git checkout -b LOCAL_BRANCH_NAME origin/ORIGIN_BRANCE_NAME

回滚操作

git 操作万一失误了，怎么办？放心，git 提供了强大的故障恢复机制，提供 git reset 命令来提供回滚操作。

$ echo "just a text" > test.txt

# 对 test.txt 进行跟踪

$ git add .

$ git status

On branch master

Changes to be committed:

  (use "git reset HEAD <file>..." to unstage)

        new file:   test.txt

# 回滚

$ git reset

$ git status

On branch master

Untracked files:

  (use "git add <file>..." to include in what will be committed)

        test.txt

nothing added to commit but untracked files present (use "git add" to track)

$ rm c.txt

$ git add .

$ git commit -m "rm c.txt"

$ git log --oneline

0ac49d7 rm c.txt

aa403d4 add b2.txt

e4bf2fe add b1.txt

...

$ ls

a.txt*  b.txt*  b1.txt*  b2.txt*

# 回滚到 rm 前的

$ git reset --hard HEAD~2

HEAD is now at e4bf2fe add b1.txt

$ ls

a.txt*  b.txt*  b1.txt*  c.txt*

$ git log --oneline

e4bf2fe add b1.txt

b0ccab5 c.txt

...

也可以搭配 git reflog（可看到所有的 git 操作记录）来进行回滚，如执行了错误的 rebase 时，就可以搭配进行救急。

$ git reflog

e7ebdde HEAD@{0}: reset: moving to HEAD~1

d7154af HEAD@{1}: commit: add test.txt

e7ebdde HEAD@{2}: reset: moving to HEAD

# 回滚到 add test.txt 这个阶段

$ git reset --hard HEAD@{1}

附录A 本地版本库

若没有远程 git 仓库，没法很好的练习 git 操作咋办呢？没问题，我们可以使用本地版本库。通过在本地创建一个 git 仓库，可以将其 clone 到另一路径，然后进行 git 操作.

$ cd repo

$ git init sample.git

$ cd ..

$ git clone repo/sample.git

其实就是 git 本地协议的支持，将本地硬盘的一个目录作为远程版本库来使用。git 支持 4 种协议：

本地协议
HTTP(S) 协议
SSH 协议
git 协议

附录B 支持 http 方式 clone

想通过 HTTP 方式来进行 git clone 操作，是需要配置 httpd 服务的.

1 安装软件

为了使用 git-http-backend(支持 git 的 CGI 程序), 需要按照 git-core，apache 支持 git 就靠它

$ yum install -y git git-core httpd

2 配置 http 账户

# 修改仓库所有者，使得 apache 可以访问

$ chown -R apache:apache /workspace/gitrepo

# 创建 apache 账户 tanlang.

# -m：使用 MD5 算法对密码进行加密

# -c：创建一个加密文件

$ htpasswd -m -c /etc/httpd/conf.d/git.htpassd tanlang

New password:

Re-type new password:

Adding password for user tanlang

# 修改 git.htpasswd 文件的所有者与所属群组, 以及权限

$ chown apache:apache /etc/httpd/conf.d/git.htpassd

$ chmod 640 /etc/httpd/conf.d/git.htpassd

3 配置 httpd

修改 /etc/httpd/conf/httpd.conf 配置文件，末尾添加如下内容.

<VirtualHost *:80>

        ServerName 106.xxxx.xxx                                     # 服务器地址/域名

        SetEnv GIT_HTTP_EXPORT_ALL

        SetEnv GIT_PROJECT_ROOT /workspace/gitrepo/                 # 代码存放路径

        ScriptAlias /git/ /usr/libexec/git-core/git-http-backend/   # 以/git/开头的访问路径映射至git的CGI程序git-http-backend

        <Location />

                AuthType Basic

                AuthName "Git"

                AuthUserFile /etc/httpd/conf.d/git.htpasswd         # 验证用户帐户的文件

                Require valid-user

        </Location>

</VirtualHost>

4 启动服务

$ systemctl enable httpd

$ systemctl start httpd

5 测试

通过以上步骤，就可以使用 http 方式进行 clone 了.

$ git clone http://***/git/sample.git

Cloning into 'sample'...

附录C 将 git 上的项目 push 到自己的 repo

以 spring-framework 为例，当 clone 下这个项目后，改动代码，提交变更, 然后 push 的话会 push 到 github 上去。那么如果我们只想将代码 push 到自己的 git 仓库呢？其实很简单，只需要添加自己的远程仓库地址，在 push 是选择 push 到我们自己的仓库就行.

$ git remote add bascker ssh://IP/root/workspace/gitrepo/spring-framework.git

$ git remote -v

origin  https://github.com/spring-projects/spring-framework.git (fetch)

origin  https://github.com/spring-projects/spring-framework.git (push)

bascker ssh://IP/root/workspace/gitrepo/spring-framework.git (fetch)

bascker ssh://IP/root/workspace/gitrepo/spring-framework.git (push)

用小乌龟 push 时，选择目标 bascker 分支即可.