progit之 git 基础（2）（获取Git仓库、记录更新到仓库、撤销操作、远程仓库的使用）

git 基础

本章涵盖了在使用Git完成各种工作中将要使用的各种基本命令。在学习完本章后，你应该能配置并初始化一个仓库（repository）、开始或停止跟踪（track）文件、暂存（stage）或提交更改（commit）。同时本章也演示如何配置Git来忽略指定的文件和文件模式、如何迅速而简单地撤销错误操作、如何浏览你的项目的历史版本以及不同提交间的差异、如何向你的远程仓库推送以及如何从你的远程仓库拉取文件

一、获取git仓库

1. 在现有目录中初始化仓库

如果打算将一个本地文件夹使用git来进行管理，只需在该文件夹目录下执行

git init

该命令将会创建一个名为 .git 的子目录，这个子目录含有你初始化的Git仓库中所有的必须文件，这些文件是Git仓库的骨干。但是这一步，我们只是做了一个初始化的操作，项目里的文件并没有被跟踪。

如果当前这个文件夹里有其他文件的话，通过下列命令来跟踪这些文件并提交

git add *.c
git add LICENSE
git commit -m 'initial project version'

现在，你已经得到了一个实际维护（或跟踪）着若干个文件的Git仓库

2. 克隆现有的仓库

如果你想获得一份已经存在了的Git仓库的拷贝，需要使用 git clone 命令。Git 克隆的是该Git仓库服务器上的几乎所有数据，而不是仅仅复制完成你的工作所需要文件，这是Git区别于其他版本控制系统的一个重要特性。

克隆仓库的命令格式是git clone [url]。比如，要克隆Git的可链接库 libgit2，可使用如下命令：

git clone https://github.com/libgit2/libgit2.git

这会在当前目录下创建一个名为 “libgit2” 的目录，并在这个目录下初始化一个 .git 文件夹，从远程仓库拉取下所有数据放入 .git 文件夹，然后从中读取最新版本的文件的拷贝。如果你想克隆远程仓库的时候，自定义本地仓库的名字，可以使用如下命令，在本地创建的仓库名字将变为 mylibgit

git clone https://github.com/libgit2/libgit2.git mylibgit

git 支持多种传输协议，上面使用的是 https， 也可以使用git协议或者ssh传输协议，比如 user@server:path/to/repo.git

二、记录每次更新到仓库

工作目录下的每一个文件不外乎两种状态：已跟踪或未跟踪。已跟踪是指那些被纳入了版本控制的文件，再上一次快照中有他们的记录，工作一段时间后，他们的状态可能处于未修改，已修改或者已放入暂存区。工作目录中除已跟踪文件以外的其他文件都属于未跟踪文件，他们既不存在于上次快照的记录中，也没有放入暂存区。

编辑过某些文件之后，由于自上次提交后你对他们做了修改，Git将他们标记为已修改文件。我们将这些修改过的文件放入暂存区，然后提交所有暂存了的修改，如此反复。

1. 检查当前文件状态：

要查看哪些文件处于什么状态，可以使用 git status 命令。

# 这说明你现在的工作目录相当干净。换句话说，所有已跟踪文件在上次提交后都未被更改过。 此外，上面的信息还表明，当前目录下没有出现任何处于未跟踪状态的新文件，否则 Git 会在这里列出来。 最后，该命令还显示 了当前所在分支，并告诉你这个分支同远程服务器上对应的分支没有偏离。
$ git status
  On branch master
  nothing to commit, working directory clean


# 现在可以看到有一个新建的README文件出现在Untracked files下面。未跟踪的文件意味着Git在之前 的快照(提交)中没有这些文件;Git 不会自动将之纳入跟踪范围，除非你明明白白地告诉它“我需要跟踪该文 件”。
$ git status
  On branch master
  Untracked files:
    (use "git add <file>..." to include in what will be committed)

      README

  nothing added to commit but untracked files present (use "git add" to track)

git status 命令的输出十分详细，如果使用 git status -s 或者 git status --short，将得到一种更为紧凑的格式输出。

# 新添加的未跟踪文件前面有 ?? 标记
# 新添加到暂存区中的文件前面有 A 标记
# 修改过的文件前面有 M 标记。出现在右边的 M 表示该文件被修改了但是还没放入暂存区；出现在靠左 边的 M 表示该文件被修改了并放入了暂存区。两个M表示在工作区被修改并提交到暂存区后又在工作区中被修改了。
$ git status -s
    M README
  MM Rakefile
  A  lib/git.rb
  M  lib/simplegit.rb
  ?? LICENSE.txt

2. 跟踪新文件、暂存已修改文件

使用命令 git add 开始跟踪一个文件，或者暂存已修改文件

$ git add README

此时再查看文件状态，会发现README文件已经被跟踪，并处于暂存状态

$ git status
On branch master
Changes to be committed:
    (use "git reset HEAD <file>..." to unstage)

      new file:   README

3. 忽略文件

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

# 第一行告诉 Git 忽略所有以 .o 或 .a 结尾的文件。一般这类对象文件和存档文件都是编译过程中出现的。
# 第二 行告诉 Git 忽略所有以波浪符(~)结尾的文件
# 此外，你可能还需要忽略 log，tmp 或者 pid 目录，以及自动生成的文档等等。
$ cat .gitignore
  *.[oa]
  *~

要养成一开始就设置好 .gitignore 文件的习惯，以免将来误提交这类无用的文件

文件 .gitignore 的格式规范如下：

• 所有空行或者以 # 开头的行都会被 Git 忽略。

• 可以使用标准的 glob 模式匹配。

• 匹配模式可以以(/)开头防止递归。

• 匹配模式可以以(/)结尾指定目录。

• 要忽略指定模式以外的文件或目录，可以在模式前加上惊叹号(!)取反。

# no .a files
*.a

# but do track lib.a, even though you're ignoring .a files above
!lib.a

# only ignore the TODO file in the current directory, not subdir/TODO
/TODO

# ignore all files in the build/ directory
build/

# ignore doc/notes.txt, but not doc/server/arch.txt
doc/*.txt

# ignore all .pdf files in the doc/ directory
doc/**/*.pdf
 

4. 查看已暂存和未暂存的修改

git diff 将通过文件补丁的格式显示具体哪些行发生了改变

要查看尚未暂存的文件更新了哪些部分，不加参数直接输入 git diff

若要查看已暂存的将要添加到下次提交里的内容，可以用 git diff --cached 命令 或者 git diff --staged 

5. 提交更新

每次提交前，先用git status看下，是不是都已暂存起来了，然后再运行提交命令 git commit，这种方式会启动文本编辑器以便输入本次提交的说明。

另外，也可以在commit命令后添加 -m 选项，将提交信息与命令放在同一行。

$ git commit -m "Story 182: Fix benchmarks for speed"

 6. 跳过使用暂存区域

Git提供了一个跳过使用暂存区域的方式，只要在提交的时候，给 git commit 加上 -a选项，Git就会自动把所有已经跟踪过的文件暂存起来一并提交，从而跳过git add步骤。

  7. 移除文件

要从Git中移除某个文件，就必须要从已跟踪文件清单中移除（确切的说，是从暂存区域移除），然后提交。

可以使用 git rm 命令完成此项工作，并连带从工作目录中删除指定的文件，这样以后就不会出现在未跟踪文件清单中了。

如果只是简单地从工作目录中手工删除文件，运行 git status 时就会在 “Changes not stated for commit” 部分。

$ rm PROJECTS.md
$ git status
On branch master
Your branch is up-to-date with 'origin/master'.
Changes not staged for commit:
    (use "git add/rm <file>..." to update what will be committed)
    (use "git checkout -- <file>..." to discard changes in working
  directory)

          deleted:    PROJECTS.md

no changes added to commit (use "git add" and/or "git commit -a")

然后再运行 git rm 记录此次移除文件的操作，下一次提交时，该文件就不再纳入版本管理了。

$ git rm PROJECTS.md
rm 'PROJECTS.md'
$ git status
On branch master
  Changes to be committed:
    (use "git reset HEAD <file>..." to unstage)

      deleted:    PROJECTS.md

 如果删除之前已经修改过并且已经放到暂存区域的文件，则必须要用强制删除选项 -f 。 这是一种安全特性，用于防止误删还没有添加到快照的数据，这样的数据不能被Git恢复。

另外一种情况：我们想让文件保留在本地，但是并不想让Git继续跟踪。当你忘记添加 .gitignore文件，不小心把日志文件或者编译生成文件添加到暂存区时，这一做法尤其有用，为达这一目的，使用 --cached 选项。 git rm 命令后面可以列出文件或者目录的名字。

git rm --cached README
# 此命令删除log/目录下扩展名为.log的所有文件
git rm log/*.log

 8. 移动文件

要在Git中对文件改名，可以这么做：

$ git mv file_from file_to

它相当于以下三条命令：

$ mv file_from file_to

$ git rm file_from

$ git add file_to

9. 查看提交历史

$ git log
commit ca82a6dff817ec66f44342007202690a93763949
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Mon Mar 17 21:52:11 2008 -0700

      changed the version number

commit 085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 16:40:33 2008 -0700

      removed unnecessary test

commit a11bef06a3f659402fe7563abf99ad00de2209e6
Author: Scott Chacon <schacon@gee-mail.com>
Date:   Sat Mar 15 10:31:28 2008 -0700

      first commit

git log 不带任何参数的话，会按提交时间列出所有更新，最近的更新排在上面。

选项：

-p: 用来显示每次提交的内容差异， 也可以加上 -2 来仅显示最近两次提交。

--stat：显示每次提交的简略统计信息

--pretty：指定使用不同于默认格式的方式展示提交历史。这个选项有一些内建的子选项供你使用。比如用 oneline 将每个提交放在一行显示，查看的提交书很大时非常有用。另外，还有short、full 和 fuller 可以用。format 可以定制要显示的记录格式

--graph：当 online 或者 format 与 --graph 结合使用时尤其有用。这个选项形象地展示了你的分支、合并历史

-S：可以列出那些添加或移除了某些字符串的提交。

-- {path}: 如果只关心某些文件或者目录的提交历史，可以在gitlog选项的最后指定他们的路径。因为是放在最后位置的选项， 所以我们用两个短划线（--）隔开之前的选项和后面限定的路径名

$ git log --pretty=oneline
ca82a6dff817ec66f44342007202690a93763949 changed the version number
085bb3bcb608e1e8451d4b2432f8ecbe6306e7e7 removed unnecessary test
a11bef06a3f659402fe7563abf99ad00de2209e6 first commit

  $ git log --pretty=format:"%h - %an, %ar : %s"
  ca82a6d - Scott Chacon, 6 years ago : changed the version number
  085bb3b - Scott Chacon, 6 years ago : removed unnecessary test
  a11bef0 - Scott Chacon, 6 years ago : first commit

  $ git log --pretty=format:"%h %s" --graph
  * 2d3acf9 ignore errors from SIGCHLD on trap
  *  5e3ee11 Merge branch 'master' of git://github.com/dustin/grit
  |
  | * 420eac9 Added a method for getting the current branch.
  * | 30e367c timeout code and tests
  * | 5a09431 add timeout protection to grit
  * | e1193f8 support for heads with slashes in them
  |/
  * d6016bc require time for xmlschema
  *  11d191e Merge branch 'defunkt' into local

# 找出添加或移除了某一个特定函数的饮用的提交
  $ git log -Sfunction_name

 三、撤销操作

在任何一个阶段，你都有可能想撤销某些操作。但是有些撤销操作是不可逆的，这是在使用Git过程中，会因为操作失误而导致之前工作丢失的少有的几个地方之一。

有时我们提交完了才发现漏掉了几个文件没有添加，或者提交信息写错了。此时可以运行带有 --amend 选项的提交命令尝试重新提交。这个命令会将暂存取中的文件提交，如果自上次提交以来你还未做任何修改（例如，在上次提交之后马上执行了此命令），那么快照会保持不变，而你所修改的只是提交信息。

# 下面的操作最终只会有一个提交，第二次提交将会代替第一次提交的结果
$ git commit -m 'initial commit'
$ git add forgotten_file
$ git commit --amend

1. 取消暂存的文件

如果你修改了两个文件并且想要将它们作为两次独立的修改提交，但却意外的输入了 git add * 暂存了他们两个，如何取消一个暂存呢？

git status 命令提示你，在 “changes to be committed” 文字下方，提示使用 git reset HEAD <file> ...来取消暂存。

如： $ git reset HEAD CONTRIBUTING.md

虽然在使用时加上 --hard 选项可以令 git reset 成为一个危险的命令，可能导致工作目录中当前进度丢失，但是不加选项地使用 git reset 并不危险——他指挥修改暂存区域。 

2. 撤销对文件的修改

如果你并不想保留对某个文件所做的修改，该如何方便的撤销修改——将它还原成上次提交时的样子？

git status 也提示了应该如何做， 在“Changes not stages for commit”下方，提示 use "git chechout -- <file> ..." to discard changes in working directory

如：$ git checkout -- CONTRIBUTING.md

git checkout -- <file> 是一个危险的命令，你对那个文件做的任何修改都会消失—你只是拷贝了另一个文件来覆盖它。

除非你确实清楚不想要那个文件了，否则不要使用这个命令。

四、远程仓库的使用

为了能在任意 Git 项目上协作，你需要知道如何管理自己的远程仓库。远程仓库是指托管在因特网或其他网络中的你的项目的版本库。

你可以有好几个远程仓库，有些仓库对你只读，有些可以读写。与他人协作涉及管理远程仓库以及根据需要推送或拉取数据。管理远程仓库包括了解如何添加远程仓库、移除无效的远程仓库、管理不同的远程分支并定义它们是否被跟踪的等等。

1. 查看远程仓库

如果想查看你已经配置的远程仓库服务器，可以运行git remote 命令，它会列出你指定的每一个远程服务器的简写。

你也可以指定选项 -v ，会显示需要读写远程仓库使用的Git保存的简写与其对应的URL

如果想查看某一个远程仓库的更多信息，可以使用 git remote show [remote-name] 命令

 $ git remote
 origin

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

  $ git remote show origin
  * remote origin

    Fetch URL: https://github.com/schacon/ticgit
    Push  URL: https://github.com/schacon/ticgit
    HEAD branch: master
    Remote branches:

      master                               tracked

      dev-branch                           tracked
    Local branch configured for 'git pull':

      master merges with remote master
    Local ref configured for 'git push':

      master pushes to master (up to date)

2. 添加远程仓库

运行 git remote add <shortname> <url> 添加一个新的远程 Git 仓库，同时指定一个你可以轻松引用的简写

  $ git remote
  origin
  $ git remote add pb https://github.com/paulboone/ticgit
  $ git remote -v
  origin  https://github.com/schacon/ticgit (fetch)
  origin  https://github.com/schacon/ticgit (push)
  pb  https://github.com/paulboone/ticgit (fetch)
  pb  https://github.com/paulboone/ticgit (push)

# 现在你可以在命令行中使用 pb 来代替整个 url

3. 从远程仓库抓取与拉取

从远程仓库获取数据，可以执行：

$ git fetch [remote-name]

如果你使用clone命令克隆了一个仓库，命令会自动将其添加为远程仓库并默认以“origin”为简写。

git fetch命令会将数据拉取到你的本地仓库，它并不会自动合并或修改你当前的工作。当准备好时你必须手动将其合并入你的工作。

4. 推送到远程仓库

当你想分享你的项目时，必须将其推送到上游。只有当你有所克隆服务器的写入权限，并且之前没有人推送过时，这条命令才能生效。

如果有其他人先推送到上游，你再推送，你的推送就会被拒绝。你必须先将它们的工作拉取下来并将其合并进你的工作后才能推送。

git push [remote-name] [branch-name]

$ git push origin master

5. 远程仓库的移除与重命名

如果想重命名引用的名字可以运行 git remote rename 去修改一个远程仓库的简写名。

这样同样也会修改你的远程分支名字，那些过去引用pb/master 的现在会引用 paul/master

如果因为某些原因想要移除一个远程仓库，可以使用 git remote rm

$ git remote rename pb paul
$ git remote
origin
paul

  $ git remote rm paul
  $ git remote
  origin