[TOC]

Git 分布式版本控制系统

一、Git 介绍

1 集中式与分布式

集中式版本控制系统: 版本库是集中存放在中央服务器, 必须联网（或局域网）才能工作;

如：SVN、CVS、ClearCase和VSS等。
分布式版本控制系统: 每个协作者本地都有一个完整的版本库;

如：BitKeeper、Mercurial和Bazaar等。

二、Git 安装

Linux: 安装命令sudo apt-get install git;
MacOS X: 通过 homebrew 或 Xcode 安装;
Windows: MSysGit - Windows版Git;

# 设置用户名及邮箱：
$ git config --global user.name "Your Name"
$ git config --global user.email "email@example.com"

三、创建版本库 (Repository)

一个由Git管理的目录文件，其中每个文件的创建、修改、删除，Git都可以跟踪，以便追踪历史，或回退到过去某一版本。
工作区和暂存区概念
- 目录 = 工作区 + 版本库(.git)
- 版本库 = 暂存区 + 分支
- git commit只将暂存区(git add而来)的内容commit.

1 创建版本库目录

$ mkdir devdocmark

2 初始化版本库

# 使当前目录初始化为Git可以管理的仓库
$ git init

注意点：版本控制系统，其实只能跟踪文本文件的改动，比如TXT文件，网页，所有的程序代码等等；图片、视频（包括 Word）这些二进制文件，虽然也能由版本控制系统管理，但没法跟踪文件的内容变化。

3 把文件添加到暂存区

# 添加指定文件
$ git add <file>
# 添加当前目录下所有发生变动的文件
$ git add .

4 把文件提交到当前分支

# 提交暂存区文件到当前分支
$ git commit -m "提交文件的注释"

四、版本控制

1 常用命令

# 查看版本库当前状态，显示未add和未commit的文件
$ git status
# 查看文件内容的变动详情，显示的格式正是Unix通用的diff格式
$ git diff
# 显示从最近到最远的提交日志，如果输出信息太多，可以加上`--pretty=oneline`参数,使每次提交只有一行的信息
$ git log

2 版本回退

在Git中，HEAD 表示当前版本，上一个版本为 HEAD^，上上一个版本为 HEAD^^，上100个版本可以写成 HEAD~100

# 回退到上一个版本, 使用HEAD指针
$ git reset --hard "HEAD^"
# 回退到上一个版本, 使用commit-id
$ git reset --hard <commit-id>
# 查看命令历史，可以看到之前所在的commit-id
$ git reflog

3 撤销修改或删除

# 把file文件在工作区的修改全部撤销
$ git checkout -- <file>

两种情况：

file修改（删除）后还没有被添加到暂存区，撤销修改后回到和版本库一致的状态;

file已经添加到暂存区后，又作了修改，现在撤销修改就回到添加到暂存区后的状态。 注：即文件回到最近一次 git commit或 git add时的状态; 命令中的 -- 很重要，若没有–，就变成“切换到另一个分支”的命令

4 删除文件

# 从版本库中删除该文件
$ git rm <file>

五、远程版本库

1 关联远程库

若本地有项目，在 GitHub 或其他代码仓库需要新建项目版本库则使用关联方法。

# 关联远程库(git ssh协议,也可以使用 https 协议)
$ git remote add origin git@github.com:jiangydev/devdocmark.git
# 推送当前分支到远程(origin)的 master 分支
$ git push -u origin master
# 拉取远程(origin)的 master 分支到本地
$ git pull origin master

# 建立本地分支和远程分支的关联
$ git branch --set-upstream <branch-name> origin/<branch-name>

origin是Git默认的远程库名称，可以修改名称，git remote命令可以查看远程库名称；

远程库为空、本地第一次推送，使用-u参数，Git不仅会把本地的当前分支内容推送到远程新的对应分支，还会把本地分支和远程分支关联起来；使用-f参数，强制推送分支内容；在以后的推送或者拉取时可以不加参数。

2 克隆远程库

若在 GitHub 或其他代码仓库已有项目版本库的情况下可以使用克隆方法。

# 克隆远程库(git ssh协议,也可以使用 https 协议)
$ git clone git@github.com:jiangydev/devdocmark.git

六、分支管理

1 新建、切换、查看、合并、删除分支

# 新建 dev 分支，并切换到 dev
$ git checkout -b dev
# 新建 dev 分支
$ git branch dev

# 切换到 dev 分支
$ git checkout dev

# 查看当前所在的分支和所有分支
$ git branch

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

# 删除 dev 分支
$ git branch -d dev

2 冲突解决

git merge <name>合并分支时(默认 Fast forward 模式)，会提示冲突内容；

使用--no-ff参数禁用Fast forward模式;

# git log也可以看到分支的合并情况
$ git log --graph --pretty=oneline --abbrev-commit

# 使用普通模式合并 dev分支
$ git merge --no-ff -m "merge dev with no-ff" dev

3 现场暂存

暂存当前工作区后，工作区是 clean的，此时可以进行其他的修改。

# 暂存当前工作区
$ git stash
# 查看stash内容
$ git stash list

# 恢复现场
$ git stash apply
# 删除stash
$ git stash drop

# 恢复现场并删除stash
$ git stash pop

七、标签管理

1 创建、查看、删除标签

默认标签是打在最新提交的commit上, 可以根据 commit-id 打标签

# 创建新标签
$ git tag <tagname>
# 查看所有标签
$ git tag

# 在指定的 commit-id上打标签
$ git tag -a <tagname> -m "" <commit-id>
# 用私钥签名标签
$ git tag -s <tagname> -m "" <commit-id>

# 查看标签详细信息
$ git show <tagname>

# 删除标签
$ git tag -d <tagname>

2 远程标签

创建的标签只存储在本地，不会自动推送到远程;

删除远程标签前，先删除本地标签；

# 一次性推送全部尚未推送到远程的本地标签
$ git push origin --tags

# 删除远程标签
$ git push origin :refs/tags/<tagname>

八、Git其他

1 设置别名

Windows 下配置文件路径为 /c/User/(your name)/.gitconfig

# 设置别名
$ git config --global alias.co checkout
$ git config --global alias.ci commit
$ git config --global alias.br branch
$ git config --global alias.lg "log --color --graph --pretty=format:'%Cred%h%Creset -%C(yellow)%d%Creset %s %Cgreen(%cr) %C(bold blue)<%an>%Creset' --abbrev-commit"

# 删除别名
$ git config --unset --global alias.br

2 忽略文件

使用 .gitignore文件设置忽略规则，GitHub上的项目 gitignore 已提供模板；
忽略文件的原则
- 忽略自动生成的文件；
- 忽略编译生成的中间文件、可执行文件等, 如Java编译产生的.class文件；
- 忽略带有敏感信息的配置文件，如存放口令的配置文件。

# 强制添加忽略规则中的文件
$ git add -f ignore.class

# 忽略规则检查
$ git check-ignore -v

3 Git 服务器搭建

可以使用 Docker 搭建。

九、同步Fork的项目至最新

1 参考资料

[1]GitHub Help.Configuring a remote for a fork[OL].https://help.github.com/articles/configuring-a-remote-for-a-fork .[2018-5-20].

[2]GitHub Help.Syncing a fork[OL].https://help.github.com/articles/syncing-a-fork .[2018-5-20].

2 步骤

2.1 为一个分叉(fork)配置一个remote

您必须配置一个指向 Git 上游存储库的remote，来在原始存储库的fork中同步您所做的更改。这还允许您将原始存储库中所做的更改与fork同步。

打开Git Bash

列出当前配置的远程仓库

$ git remote -v
origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
origin  https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)

指定一个新的将被fork同步的远程上游仓库

$ git remote add upstream https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git

验证您已经指定的上游仓库是否存在

$ git remote -v
origin    https://github.com/YOUR_USERNAME/YOUR_FORK.git (fetch)
origin    https://github.com/YOUR_USERNAME/YOUR_FORK.git (push)
upstream  https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (fetch)
upstream  https://github.com/ORIGINAL_OWNER/ORIGINAL_REPOSITORY.git (push)

2.2 同步fork

打开Git Bash
切换到您本地项目的工作目录

从上游仓库获取(fetch)分支及它们各自的提交。提交至master的Commits将被存储为一个本地分支，如 upstream/master.

$ 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的本地master分支

$ git checkout master
Switched to branch 'master'

从 upstream/master 合并到您的本地 master 分支。这会导致您的fork master分支与上游仓库同步，且不会丢失本地的变化。

$ 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

如果您的本地分支没有任何独特的commits，Git会以”fast-forward”代替执行：

$ git merge upstream/master
Updating 34e91da..16c56ad
Fast-forward
 README.md                 |    5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

Git 安装及使用