Git User guide

A.1安装和初始化
Setup and Initialization

在使用Git之前，须要先进行配置。在使用一个新的版本库之前，须要先初始化。本节介绍与Git设置和初始化相关的命令。

配置全局用户名和电子邮件地址
prompt>git config --global user.name "Your Name"
prompt>git config --global user.email "[e-mail]"
为特定的版本库配置用户名和电子邮件地址

注意：你可以为每个版本库单独设置用户名和邮件地址。这使得用户可在不同项目中使用不同的用户名和/或不同的邮件地址。

prompt>cd /path/to/repo
prompt>git config user.name "Your Name"
prompt>git config [e-mail]

在命令行中使用不同颜色显示不同内容
prompt>git config --global color.ui "auto"

初始化新版本库
prompt>mkdir /path/to/repo
prompt>cd /path/to/repo
prompt>git init
Initialized empty Git repository in /path/to/repo/.git/
prompt>
... create file(s) for first commit ...
prompt>git add .
prompt>git commit -m 'initial import'
Created initial commit bdebe5c: initial import

1 files changed, 1 insertions(+), 0 deletions(-)

create mode 100644 <some file>

克隆版本库
prompt>git clone <repository url>
Initialize repo/.git
Initialized empty Git repository in /work/<remote repository>/.git/

将目录中的内容纳入Git版本控制
prompt>cd /path/to/existing/directory
prompt>git init
Initialized empty Git repository in /path/to/existing/directory/.git/
prompt>git add .
prompt>git commit -m "initial import of some project"

在本地版本库中设置远程版本库的别名
... from within the repository directory ...
prompt>git remote add <remote repository> <repository url>



A.2 日常操作
Normal Usage

本节列出Git日常操作命令，对应于第4章“添加与提交：Git基础”（第41页）。

添加新文件或暂存已有文件上的改动，然后提交
prompt>git add <some file>
prompt>git commit -m "<some message>"

暂存已有文件上的部分修改
注意：[...]表示可选参数。

prompt>git add -p [<some file> [<some file> [and so on]]]
选择要提交的文本块……

使用交互方式添加文件
prompt>git add -i

暂存已纳入Git版本控制之下的文件的修改
prompt>git add -u [<some path> [<some path>]]

提交已纳入Git版本控制之下的文件的所有修改
prompt>git commit -m "<some message>" -a

清除工作目录树中的修改
prompt>git checkout HEAD <some file> [<some file>]

取消已暂存但尚未提交的修改的暂存标识
prompt>git reset HEAD <some file> [<some file>]

修复上一次提交中的问题

改动相关文件，并暂存……
prompt>git commit -m "<some message>" --amend

修复上一次提交中的问题，并复用上次的提交注释
prompt>git commit -C HEAD --amend



A.3 分支
Branches

分支是Git的强项之一。本节介绍关于分支的各个命令。详细内容见第5章“理解和使用分支”（第55页）。

列出本地分支
prompt>git branch

列出远程分支
prompt>git branch -r

列出所有分支
prompt>git branch -a

基于当前分支（的末梢）创建新分支
prompt>git branch <new branch>

检出另一条分支
prompt>git checkout <some branch>

基于当前分支创建新分支，同时检出该分支
prompt>git checkout -b <new branch>

基于另一个起点，创建新分支
你可以从版本库中的任何一个版本开始创建新分支。这个起始点可以用一条已有的分支名称、一个提交名称，或者一个标签名称来表达。
prompt>git branch <new branch> <start point>

创建同名新分支，覆盖已有分支
prompt>git branch -f <some existing branch> [<start point>]

移动或重命名分支
只有当<new branch>不存在时
prompt>git checkout -m <existing branch name> <new branch name>

如果<new branch>已存在，就覆盖它
prompt>git checkout -M <existing branch name> <new branch name>

把另一条分支合并到当前分支
prompt>git merge <some branch>

合并，但不提交
prompt>git merge --no-commit <some branch>

拣选合并，并且提交
prompt>git cherry-pick <commit name>

拣选合并，但不提交
prompt>git cherry-pick -n <commit name>

把一条分支上的内容压合到另一条分支（上的一个提交）
prompt>git merge --squash <some branch>

删除分支
仅当欲删除的分支已合并到当前分支时
prompt>git branch -d <branch to delete>

不论欲删除的分支是否已合并到当前分支
prompt>git branch -D <branch to delete>



A.4 历史
History

这些命令用来显示版本库的历史信息，包括代码曾在哪里、谁在何时做了什么、修改的内容及其统计信息。详见第6章“查询Git历史记录”（第71页）。

显示全部历史记录
prompt>git log

显示版本历史，以及版本间的内容差异
prompt>git log -p

只显示最近一个提交
prompt>git log -1

显示最近的20个提交，以及版本间的内容差异
prompt>git log -20 -p

显示最近6小时的提交
prompt>git log --since="6 hours"

显示两天之前的提交
prompt>git log --before="2 days"

显示比HEAD（当前检出分支的末梢）早3个提交的那个提交
prompt>git log -1 HEAD~3
或者……
prompt>git log -1 HEAD^^^
或者……
prompt>git log -1 HEAD~1^^

显示两个版本之间的提交
下面命令中的<start point>和<end point>可以是一个提交名称、分支名称、标签名称，或者它们的混合。
prompt>git log <start point>...<end point>

显示历史，每个提交显示一行，包括提交注释的第一行
prompt>git log --pretty=oneline

显示改动行数统计
prompt>git log --stat

显示改动文件的名称和状态
prompt>git log --name-status

显示当前工作目录树和暂存区间的差别
prompt>git diff

显示暂存区和版本库间的差别
prompt>git diff --cached

显示工作目录树和版本库间的差别
prompt>git diff HEAD

显示工作目录树与版本库中某次提交版本之间的差别
<start point>可以是一个提交名称、分支名称或标签名称。
prompt>git diff <start point>

显示版本库中两个版本之间的差别
prompt>git diff <start point> <end point>

显示差别的相关统计
prompt>git diff --stat <start point> [<end point>]

显示文件中各个部分的修改者及相关提交信息
prompt>git blame <some file>

显示文件中各个部分的修改者及相关提交信息，包括在该文件中复制、粘贴和移动内容等方面的情况。
prompt>git blame -M <some file>

显示文件中各部分的修改者及相关提交信息，包括在文件间移动内容方面的情况
prompt>git blame -C -C <some file>

显示历史时，显示复制和粘贴信息
prompt>git log -C -C -p -1 <some point>



A.5 远程版本库
Remote Repositories

开发人员之间通过远程版本库来共享工作成果，相互协作。本节介绍关于这些操作的命令，详见第7章“与远程版本库协作”（第91页）。

克隆远程版本库
prompt>git clone <some repository>

克隆远程版本库，但只下载其中最近200个提交的历史记录
prompt>git clone --depth 200 <some repository>

在本地版本库中设置远程版本库的别名
prompt>git remote add <remote repository> <repository url>

显示远程分支
prompt>git branch -r

基于远程分支创建本地分支
prompt>git branch <new branch> <remote branch>

基于远程标签创建本地分支
prompt>git branch <new branch> <remote tag>

从别名为“origin”的远程版本库中取来修改变化，但不合并到本地分支
prompt>git fetch

从任意的远程版本库中取来修改变化，但不合并到本地分支
prompt>git fetch <remote repository>

从任意的远程版本库中取来修改变化，并合并到当前检出的本地分支
prompt>git pull <remote repository>

从别名为“origin”的远程版本库中取来修改变化，并合并到当前检出的本地分支
prompt>git pull

把修改变化从本地分支推入远程版本库
prompt>git push <remote repository> <local branch>:<remote branch>

把修改变化从本地分支推入远程版本库中同名分支
prompt>git push <remote repository> <local branch>

把修改变化从本地新建分支推入远程版本库
prompt>git push <remote repository> <local branch>

把修改变化推入别名为“origin”的远程版本库
当远程版本库中已有同名分支时，这个命令会推入本地分支到远程版本库对应的分支中。如果远程版本库中尚无同名分支，则须使用git push <repository name> <local branch>。
prompt>git push

在远程版本库中删除分支
prompt>git push <remote repository> :<remote branch>

在本地版本库中删除所有远程版本库中已不存在的分支
prompt>git remote prune <remote repository>

在本地版本库中删除某个远程版本库的简称，以及该远程版本库相关的分支
prompt>git remote rm <remote repository>

A.6 连接Git和SVN
Git to SVN Bridge

Git可以读取Subversion版本库中的数据，并把本地修改发送回Subversion版本库。这是Git区别于其他版本控制工具的必杀技之一。相关详细介绍请参见第10章“迁移到Git”（第131页）。
克隆SVN版本库的全部内容
prompt>git svn clone <svn repository>

克隆具有标准结构的SVN版本库
下面命令适用于克隆标准结构的SVN数据库，也就是说，主干命名为trunk，其他分支都存放于branches目录下，标签都存放于tags目录下。
prompt>git svn clone -s <svn repository>

克隆非标准结构的SVN版本库
prompt>git svn clone -T <trunk path> \

-b <branch path> \

-t <tag path> \


<svn repository>
克隆具有标准结构的SVN版本库中的某个版本（比如第2321版）
prompt>git svn clone -s -r 2321

克隆具有标准结构的SVN版本库，并对SVN中的分支添加前缀
prompt>git svn clone -s --prefix svn/ <svn repository>

从上游SVN版本库中获得更新的内容，并依此在本地Git版本库中变基本地分支
prompt>git svn rebase

把修改变化推回上游SVN版本库
prompt>git svn dcommit

列出所有将推入上游SVN版本库的提交
prompt>git svn dcommit -n

显示SVN历史记录
prompt>git svn log

显示文件中各个部分的SVN的修改者及相关提交信息
prompt>git svn blame <some file>