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。

---

参考资料：

• Git官方使用说明
• Git教程-廖雪峰