GIT备忘手册

开始使用

设置身份

$ git config --global user.name "Your Name"
$ git config --global user.email "email@example.com"

注意git config命令的--global参数，用了这个参数，表示你这台机器上所有的Git仓库都会使用这个配置，当然也可以对某个仓库指定不同的用户名和Email地址，不使用--global参数即可。

push到远程仓库

创建仓库

通过git init命令把这个目录变成Git可以管理的仓库，会在当前目录下生成一个.git的目录。

$ git init

添加到暂存区

用命令git add <file>告诉Git，把文件添加到仓库,可反复多次使用，添加多个文件：

<!--指定文件-->
$ git add file2.txt file3.txt

<!--当前目录全部文件-->
$ git add .

提交到本地仓库

用命令git commit -m <message>告诉Git，把文件提交到仓库

$ git commit -m "wrote a readme file"

推送到远程仓库

<!-- 添加远程仓库需使用如下命令设置，已添加则不需设置 -->
$ git remote add origin <name> <url>
<!-- 推送到远程仓库 -->
$ git push <name>
git push -u origin master

常用命令速查

全局配置

git config --global user.name "robbin"
git config --global user.email "fankai@gmail.com"
git config --global color.ui true    # 让Git显示颜色
git config --global alias.co checkout  # 设置别名
git config --global alias.ci commit
git config --global alias.st status
git config --global alias.br branch
git config --global core.editor "mate -w"    # 设置Editor使用textmate
git config -l  # 列举所有配置
git config --global credential.helper store   # 记住帐号密码，不用每次验证

用户的git配置文件~/.gitconfig

常用命令

查看、添加、提交、删除、找回，重置修改文件

git help <command>  # 显示command的help
git show            # 显示某次提交的内容
git show $id

git co  -- <file>   # 抛弃工作区修改
git co  .           # 抛弃工作区修改

git add <file>      # 将工作文件修改提交到本地暂存区
git add .           # 将所有修改过的工作文件提交暂存区

git rm <file>       # 从版本库中删除文件
git rm <file> --cached  # 从版本库中删除文件，但不删除文件

git reset <file>    # 从暂存区恢复到工作文件
git reset -- .      # 从暂存区恢复到工作文件
git reset --hard    #

恢复最近一次提交过的状态，即放弃上次提交后的所有本次修改

git ci <file>
git ci .
git ci -a           # 将git add, git rm和git ci等操作都合并在一起做
git ci -am "some comments"
git ci --amend      # 修改最后一次提交记录

git revert <$id>    # 恢复某次提交的状态，恢复动作本身也创建了一次提交对象
git revert HEAD     # 恢复最后一次提交的状态

查看文件diff

git diff <file>     # 比较当前文件和暂存区文件差异
git diff
git diff <$id1> <$id2>   # 比较两次提交之间的差异
git diff <branch1>..<branch2> # 在两个分支之间比较
git diff --staged   # 比较暂存区和版本库差异
git diff --cached   # 比较暂存区和版本库差异
git diff --stat     # 仅仅比较统计信息

查看提交记录

git log
git log --graph --pretty=oneline --abbrev-commit
git log <file>      # 查看该文件每次提交记录
git log -p <file>   # 查看每次详细修改内容的diff
git log -p -2       # 查看最近两次详细修改内容的diff
git log --stat      # 查看提交统计信息
# tig Mac上可以使用tig代替diff和log，brew install tig

Git 本地分支管理

查看、切换、创建和删除分支

git br -r           # 查看远程分支
git br <new_branch> # 创建新的分支
git br -v           # 查看各个分支最后提交信息
git br --merged     # 查看已经被合并到当前分支的分支
git br --no-merged  # 查看尚未被合并到当前分支的分支

git checkout <branch>     # 切换到某个分支
git checkout -b <new_branch> # 创建新的分支，并且切换过去
git checkout -b <new_branch> <branch>  # 基于branch创建新的new_branch

git checkout $id          # 把某次历史提交记录checkout出来，但无分支信息，切换到其他分支会自动删除
git checkout $id -b <new_branch>  # 把某次历史提交记录checkout出来，创建成一个分支

git br -d <branch>  # 删除某个分支
git br -D <branch>  # 强制删除某个分支 (未被合并的分支被删除的时候需要强制)

分支合并和rebase

git merge <branch>               # 将branch分支合并到当前分支
git merge origin/master --no-ff  # 不要Fast-Foward合并，这样可以生成merge提交

git rebase master <branch>       # 将master rebase到branch，相当于：
git checkout <branch> && git rebase master && git co master && git merge <branch>

Git远程分支管理

git pull                         # 抓取远程仓库所有分支更新并合并到本地
git pull --no-ff                 # 抓取远程仓库所有分支更新并合并到本地，不要快进合并
git branch --set-upstream-to=origin/dev dev   # 将本地分支与远程分支关联
git fetch origin                 # 抓取远程仓库更新
git merge origin/master          # 将远程主分支合并到本地当前分支
git checkout --track origin/branch     # 跟踪某个远程分支创建相应的本地分支
git checkout -b <local_branch> origin/<remote_branch>  # 基于远程分支创建本地分支，功能同上

git push                         # push所有分支
git push origin master           # 将本地主分支推到远程主分支
git push -u origin master        # 将本地主分支推到远程(如无远程主分支则创建，用于初始化远程仓库)
git push origin <local_branch>   # 创建远程分支， origin是远程仓库名
git push origin <local_branch>:<remote_branch>  # 创建远程分支
git push origin :<remote_branch>  #先删除本地分支(git br -d <branch>)，然后再push删除远程分支

Git补丁管理(方便在多台机器上开发同步时用)

git diff > ../sync.patch         # 生成补丁
git apply ../sync.patch          # 打补丁
git apply --check ../sync.patch  # 测试补丁能否成功

Git标签管理

一般发布版本可以采用标签形式来创建里程碑。

注意：标签总是和某个commit挂钩。如果这个commit既出现在master分支，又出现在dev分支，那么在这两个分支上都可以看到这个标签。

git tag           # 查看所有标签
git tag v1.0.0    # 从当前创建标签
git tag v1.0.0 <commitId>  # 从某个commitId创建标签
git tag -a v0.1 -m "version 0.1 released" 1094adb   # 创建带有说明的标签
git show <tagname>    # 查看标签信息
git tag -d v0.1       # 删除标签
git push origin <tagname>  # 推送某个标签到远程
git push origin --tags   # 推送全部尚未推送到远程的本地标签
# 删除远程分支需要两步：
git tag -d <tagname>   # 1.删除本地标签
git push origin :refs/tags/<tagname>   # 2.删除远程标签

Git储藏管理

git stash                        # 暂存
git stash list                   # 列所有stash
git stash apply  [stashName]               # 恢复储藏的内容
git stash drop                   # 删除储藏区
git stash pop                   # 恢复并删除储藏内容
git stash clear               # 清空储藏区

Git远程仓库管理

git remote -v                    # 查看远程服务器地址和仓库名称
git remote show origin           # 查看远程服务器仓库状态
git remote add origin git@github:robbin/robbin_site.git         # 添加远程仓库地址
git remote set-url origin git@github.com:robbin/robbin_site.git # 设置远程仓库地址(用于修改远程仓库地址)
git remote rm <repository>       # 删除远程仓库

创建远程仓库

git clone --bare robbin_site robbin_site.git  # 用带版本的项目创建纯版本仓库
scp -r my_project.git git@git.csdn.net:~      # 将纯仓库上传到服务器上

mkdir robbin_site.git && cd robbin_site.git && git --bare init # 在服务器创建纯仓库
git remote add origin git@github.com:robbin/robbin_site.git    # 设置远程仓库地址
git push -u origin master                                       # 客户端首次提交
git push -u origin develop  # 首次将本地develop分支提交到远程develop分支，并且track

git remote set-head origin master   # 设置远程仓库的HEAD指向master分支
# 也可以命令设置跟踪远程库和本地库
git branch --set-upstream master origin/master
git branch --set-upstream develop origin/develop

分支模型管理策略

master 分支

master 为主分支，也是用于部署生产环境的分支，确保master分支稳定性。
master 分支一般由develop以及hotfix分支合并而来，任何时候都不能直接修改该分支的代码。

develop分支

develop 为开发分支，始终保持最新完成以及bug修复后的代码。
一般开发的新功能时，创建的feature分支都是基于develop分支的。

feature 分支

开发新功能时，以develop为基础创建feature分支。
分支命名: feature/开头的为特性分支，命名如: feature/user_module、 feature/cart_module。

release分支

release为预上线分支，发布提测阶段，会以release分支代码为基准提测。
当有一组feature开发完成，首先会合并到develop分支，进入提测时，会创建release分支。如果测试过程中若存在bug需要修复，则直接由开发者在release分支修复并提交。当测试完成之后，合并release分支到master和develop分支，此时master为最新代码，用作上线。

hotfix 分支

分支命名: hotfix/ 开头的为修复分支，它的命名规则与 feature 分支类似。
线上出现紧急问题时，需要及时修复，以master分支为基线，创建hotfix分支，修复完成后，需要合并到master分支和develop分支。

其中master和develop分支为常设分支，远程仓库中也应包含这两个分支；其他的为临时性分支，使用完成后应该删除，也建议不要推送到远程仓库。

具体规范参考：Git分支管理策略

GIT 提交规范推荐

GIT提交时的粒度应该是一个小功能点或者一个bugFix，这样进行恢复操作时能够将影响范围降到最低。

为了方便跟踪工程历史，编写良好的版本发布日志，我们应该编写一个良好的commit messages。建议采用当前广泛应用的 Angular Git CommitGuidelines规范。

每次提交，Commit message 可以包括三个部分：Header，Body 和 Footer。

<type>(<scope>): <subject>  // header
// 空一行
<body>
// 空一行
<footer>

其中，Header 是必需的，Body 和 Footer 可以省略。不管是哪一个部分，任何一行都不得超过72个字符（或100个字符），这是为了避免自动换行影响日志查阅。

Header

Header部分只有一行，包括三个字段：type（必需）、scope（可选）和subject（必需）。

Type

type用于说明 commit 的类别，只允许使用下面7个标识。

feat：新功能（feature）
fix：修补bug
docs：文档（documentation）
style：格式（不影响代码运行的变动）
refactor：重构（即不是新增功能，也不是修改bug的代码变动）
test：增加测试
chore：构建过程或辅助工具的变动

如果type为feat和fix，则该 commit 将肯定出现在 ChangeLog 之中。其他情况，如：docs、chore、style、refactor、test，根据实际情况决定是否放入 ChangeLog，建议不放入。

Scope

scope用于说明 commit 影响的范围，比如数据层、控制层、视图层等等，视项目不同而不同，本项目建议采用模块区分，如：模版编辑、数据更新。

Subject

subject是 commit 目的的简短描述，不超过50个字符；以动词开头，使用第一人称现在时，比如change，而不是changed或changes；第一个字母小写，结尾不加句号。

Body

Body 部分是对本次 commit 的详细描述，可以分成多行。

Footer

Footer 部分只用于不兼容变动或关闭 Issue。

参考资料：