• 作者：约克
• 原文地址：
• 文章版权归作者所有，转载请注明出处！

前言

Git 的工作就是创建和保存你项目的快照及与之后的快照进行对比。常用的是以下 6 个命令：

• git clone
• git push
• git add
• git commit
• git checkout
• git pull

名词说明：

• workspace：工作区
• staging area：暂存区/缓存区
• local repository：本地仓库
• remote repository：远程仓库

一，Git 配置

Git 自带一个 git config 的工具来帮助设置控制 Git 外观和行为的配置变量。

1.1. 配置变量存储位置

• /etc/gitconfig

  包含系统上每一个用户及他们仓库的通用配置。

  # use system config file
  $ git config --list --system

• ~/.gitconfig

  当前用户配置。

  # use global config file
  $ git config --list --global

• 当前仓库 .git/config

  当前使用仓库。

  # use repository config file
  $ git config --list --local

每一个级别会覆盖上一级别的配置，所以 .git/config 的配置变量会覆盖 /etc/gitconfig 中的配置变量。

1.2. 配置命令

# 查看当前用户
$ git config user.name

# 显示当前的Git配置
$ git config --list

# 编辑Git配置文件
$ git config -e [--global]

# 设置提交代码时的用户信息
$ git config [--global] user.name "[name]"

$ git config [--global] user.email "[email address]"

二，初始化 Git 仓库

通常有两种获取 Git 仓库的方式

• 将尚未进行版本控制的本地目录转换为 Git 仓库。

  # 创建一个名为 .git 的子目录
  $ git init
  
  # 新建一个目录，将其初始化为Git代码库
  $ git init [project-name]
  
  # 添加远程仓库地址
  $ git remote add origin <url>

• 从其它服务器 克隆 一个已存在的 Git 仓库。

  # 克隆仓库
  $ git clone <url>

三，文件状态

工作目录下的每一个文件都不外乎这两种状态：已跟踪 或 未跟踪。文件状态流转过程：

3.1. 检查文件状态

git status 命令查看哪些文件处于什么状态。

# 详细状态
$ git status

# 简化状态
$ git status -s

3.2. 跟踪文件

使用命令 git add 开始跟踪一个文件。

# 跟踪指定文件
$ git add [file1] [file2] ...

# 跟踪指定目录，包括子目录
$ git add [dir]

# 跟踪 README.md
$ git add README.md

# 跟踪所有文件
$ git add .

3.3. 忽略跟踪文件

一般我们总会有些文件无需纳入 Git 的管理，也不希望它们总出现在未跟踪文件列表。在这种情况下，我们可以创建一个名为 .gitignore 的文件，列出要忽略的文件的模式。支持 Glob 正则模式。

$ cat .gitignore
*.[oa]
*~

3.4. 查看更新

# 显示暂存区和工作区的差异
$ git diff

# 显示工作区与当前分支最新commit之间的差异
$ git diff HEAD

# 查看已暂存的将要添加到下次提交里的内容
$ git diff --staged

3.5. 代码提交

# 提交暂存区到仓库区
$ git commit -m [message]

# 提交暂存区的指定文件到仓库区
$ git commit [file1] [file2] ... -m [message]

# 提交工作区自上次commit之后的变化，直接到仓库区
$ git commit -a

# 提交时显示所有diff信息
$ git commit -v

# 使用一次新的commit，替代上一次提交
# 如果代码没有任何新变化，则用来改写上一次commit的提交信息
$ git commit --amend -m [message]

# 重做上一次commit，并包括指定文件的新变化
$ git commit --amend [file1] [file2] ...

3.6. 移除文件

# 删除工作区文件，并且将这次删除放入暂存区
$ git rm [file1] [file2] ...

# 停止追踪指定文件，但该文件会保留在工作区
$ git rm --cached [file]

# 支持 glob 模式
$ git rm log/\*.log

3.7. 移动文件

可食用 git mv 实现对文件改名。

$ git mv <file_from_name> <file_to_name>

其实，运行 git mv 就相当于运行了下面三条命令：

$ mv README.md README

$ git rm README.md

$ git add README

3.8. 撤销

# 恢复暂存区的指定文件到工作区
$ git checkout [file]

# 恢复某个commit的指定文件到暂存区和工作区
$ git checkout [commit] [file]

# 恢复暂存区的所有文件到工作区
$ git checkout .

# 重置暂存区的指定文件，与上一次commit保持一致，但工作区不变
$ git reset [file]

# 重置暂存区与工作区，与上一次commit保持一致
$ git reset --hard

# 重置当前分支的指针为指定commit，同时重置暂存区，但工作区不变
$ git reset [commit]

# 重置当前分支的HEAD为指定commit，同时重置暂存区和工作区，与指定commit一致
$ git reset --hard [commit]

# 重置当前HEAD为指定commit，但保持暂存区和工作区不变
$ git reset --keep [commit]

# 新建一个commit，用来撤销指定commit
# 后者的所有变化都将被前者抵消，并且应用到当前分支
$ git revert [commit]

# 暂时将未提交的变化移除，稍后再移入
$ git stash

$ git stash pop

3.9. 查看提交历史

可使用 git log 命令，查看仓库提交历史。不传入任何参数的默认情况下，git log 会按时间先后顺序列出所有的提交，最近的更新排在最上面。

# 使用格式
$ git log [选项]

# -p 显示每次提交所引入的差异，-2 选项来只显示最近的两次提交
$ git log -p -2

# 查看每次提交的简略统计信息，可以使用 --stat 选项
$ git log --stat

# 搜索提交历史，根据关键词
$ git log -S [keyword]

# 将每个提交放在一行显示
$ git log --pretty=oneline

# 显示某个commit之后的所有变动，每个commit占据一行
$ git log [tag] HEAD --pretty=format:%s

# 显示某个commit之后的所有变动，其"提交说明"必须符合搜索条件
$ git log [tag] HEAD --grep feature

# 显示某个文件的版本历史，包括文件改名
$ git log --follow [file]

限制 git log 输出的选项中常用的选项：

-<n> 仅显示最近的 n 条提交。

--since, --after 仅显示指定时间之后的提交。

--until, --before 仅显示指定时间之前的提交。

--author 仅显示作者匹配指定字符串的提交。

--committer 仅显示提交者匹配指定字符串的提交。

--grep 仅显示提交说明中包含指定字符串的提交。

-S 仅显示添加或删除内容匹配指定字符串的提交。

四，远程仓库

远程仓库是指托管在因特网或其他网络中的你的项目的版本库。如果想查看你已经配置的远程仓库服务器，可以运行 git remote 命令。

4.1. 查看远程仓库

$ git remote
origin # Git 给你克隆的仓库服务器的默认名字

# 显示需要读写远程仓库使用的 Git 保存的简写与其对应的 URL
$ git remote -v

# 查看某个远程仓库
$ git remote show origin

4.2. 添加远程仓库

# 添加远程仓库
$ git remote add <shortname> <url>

4.3. 拉取数据

这个命令会访问远程仓库，从中拉取所有你还没有的数据。

$ git fetch <remote>

4.4. 远程仓库重命名

$ git remote rename pb paul

4.5. 远程仓库移除

一旦你使用这种方式删除了一个远程仓库，那么所有和这个远程仓库相关的远程跟踪分支以及配置信息也会一起被删除。

git remote remove paul

4.6. 拉取远程仓库

$ git pull [remote] [branch]

4.7. 推送到远程仓库

# 上传本地指定分支到远程仓库
$ git push [remote] [branch]

# 强行推送当前分支到远程仓库，即使有冲突
$ git push [remote] --force

# 推送所有分支到远程仓库
$ git push [remote] --all

五，打标签

Git 可以给仓库历史中的某一个提交打上标签，以示重要。 比较有代表性的是人们会使用这个功能来标记发布结点（ v1.0 、 v2.0 等等）。

5.1. 列出标签

# 以字母顺序列出标签
$ git tag

# 按照特定的模式查找标签
$ git tag -l "v1.8.5*"
v1.8.5
v1.8.5-rc0
v1.8.5-rc1

# 查看标签提交信息
$ git show v1.4-lw

5.2. 创建标签

Git 支持两种标签：轻量标签 lightweight 与附注标签 annotated。

• 附注标签

  附注标签是存储在 Git 数据库中的一个完整对象， 它们是可以被校验的，其中包含打标签者的名字、电子邮件地址、日期时间等。在 Git 中创建附注标签十分简单。 最简单的方式是当你在运行 tag 命令时指定 -a 选项：

  $ git tag -a v1.4 -m "my version 1.4"

• 轻量标签

  轻量标签很像一个不会改变的分支——它只是某个特定提交的引用。创建轻量标签，不需要使用 -a、-s 或 -m 选项，只需要提供标签名字：

  $ git tag v1.4-lw

5.3. 后期打标签

可以对过去的提交打标签。

$ git tag -a v1.2 9fceb02

5.4. 共享标签

默认情况下，git push 命令并不会传送标签到远程仓库服务器上。在创建完标签后你必须显式地推送标签到共享服务器上。

# 命令格式
$ git push origin <tagname>

$ git push origin v1.5

# 将把所有不在远程仓库服务器上的标签全部传送
$ git push origin --tags

5.5. 删除标签

# 删除掉本地仓库上的标签
$ git tag -d v1.4-lw

# 删除远程标签
$ git push origin --delete <tagname>

5.5. 检出标签

如果你想查看某个标签所指向的文件版本，可以使用 git checkout 命令。

$ git checkout v2.0.0

六，分支

Git 的分支，其实本质上仅仅是指向提交对象的可变指针。 Git 的默认分支名字是 master。 在多次提交操作之后，你其实已经有一个指向最后那个提交对象的 master 分支。 master 分支会在每次提交时自动向前移动。

6.1. 创建分支

# 创建一个分支
$ git branch <branch_name> 

# 新建一个分支，并切换到该分支
$ git checkout -b [branch]

# 新建一个分支，指向指定commit
$ git branch [branch] [commit]

# 新建一个分支，与指定的远程分支建立追踪关系
$ git branch --track [branch] [remote-branch]

6.2. 删除分支

# 删除本地分支
$ git branch -d [branch-name]

# 删除远程分支
$ git push origin --delete [branch-name]

6.3. 分支切换

# 切换到指定分支，并更新工作区
$ git checkout [branch-name]

# 切换到上一个分支
$ git checkout -b [branch-name]

# 拉取远程分支，并在本地新建分支
$ git checkout -b [branch-name] origin/[branch-name]

6.4. 合并分支

# 合并指定分支到当前分支
$ git merge [branch]

# 选择一个commit，合并进当前分支
$ git cherry-pick [commit]

参考

• [1] Git RUNOOB
• [2] 常用 Git 命令清单
• [3] Git Book