git使用简介

2.1 概念

2.1.1 取得项目的 Git 仓库

有两种取得 Git 项目仓库的方法。第一种是在现存的目录下，通过导入所有文件来创建新的 Git 仓库。第二种是从已有的 Git 仓库克隆出一个新的镜像仓库来。

• 从当前目录初始化
  要对现有的某个项目开始用 Git 管理，只需到此项目所在的目录，执行：

  $ git init
  

  初始化后，在当前目录下会出现一个名为 .git 的目录，所有 Git 需要的数据和资源都存放在这个目录中。不过目前，仅仅是按照既有的结构框架初始化好了里边所有的文件和目录，但我们还没有开始跟踪管理项目中的任何一个文件。（在第九章我们会详细说明刚才创建的 .git 目录中究竟有哪些文件，以及都起些什么作用。）

  如果当前目录下有几个文件想要纳入版本控制，需要先用 git add 命令告诉 Git 开始对这些文件进行跟踪，然后提交：

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

  稍后我们再逐一解释每条命令的意思。不过现在，你已经得到了一个实际维护着若干文件的 Git 仓库。

• 从现有仓库克隆
  如果想对某个开源项目出一份力，可以先把该项目的 Git 仓库复制一份出来，这就需要用到 git clone 命令。如果你熟悉其他的 VCS 比如 Subversion，你可能已经注意到这里使用的是 clone 而不是 checkout 。这是个非常重要的差别，Git 收取的是项目历史的所有数据（每一个文件的每一个版本），服务器上有的数据克隆之后本地也都有了。实际上，即便服务器的磁盘发生故障，用任何一个克隆出来的客户端都可以重建服务器上的仓库，回到当初克隆时的状态（可能会丢失某些服务器端的挂钩设置，但所有版本的数据仍旧还在，有关细节请参考第四章）。

  克隆仓库的命令格式为 git clone [url] 。比如，要克隆 Ruby 语言的 Git 代码仓库 Grit，可以用下面的命令：

  $ git clone git://github.com/schacon/grit.git
  

  这会在当前目录下创建一个名为 “grit” 的目录，其中内含一个 .git 的目录，并从同步后的仓库中拉出所有的数据，取出最新版本的文件拷贝。如果进入这个新建的 grit 目录，你会看到项目中的所有文件已经在里边了，准备好后续的开发和使用。如果希望在克隆的时候，自己定义要新建的项目目录名称，可以在上面的命令最后指定：

  $ git clone git://github.com/schacon/grit.git mygrit
  

  唯一的差别就是，现在新建的目录成了 mygrit，其他的都和上边的一样。

  Git 支持许多数据传输协议。之前的例子使用的是 git:// 协议，不过你也可以用 http(s):// 或者 user@server:/path.git 表示的 SSH 传输协议。我们会在后面详细介绍所有这些协议在服务器端该如何配置使用，以及各种方式之间的利弊。

2.2 常用指令

2.2.1 获得git仓库

使用 git-clone 命令下载一个仓库的拷贝。

        # git itself (approx. 10MB download):
$ git clone git://git.kernel.org/pub/scm/git/git.git
        # the Linux kernel (approx. 150MB download):
$ git clone git://git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux-2.6.git

2.2.2 git add

这是个多功能命令，根据目标文件的状态不同，此命令的效果也不同：可以用它开始跟踪新文件，或者把已跟踪的文件放到暂存区，还能用于合并时把有冲突的文件标记为已解决状态等

$ git add . # 將資料先暫存到 staging area, add 之後再新增的資料, 於此次 commit 不會含在裡面.
$ git add filename
$ git add modify-file # 修改過的檔案, 也要 add. (不然 commit 要加上 -a 的參數)
$ git add -u # 只加修改過的檔案, 新增的檔案不加入.
$ git add -i # 進入互動模式

• 描述
  
• 参数
  
• 配置
  
• 例子
  

2.2.3 git push (远程仓库名) (分支名)

2.3 实作练习

2.3.1 Git 建立 Local Repository

1:  $ mkdir project; 
2:  $ cd project
3:  $ git init
4:  $ echo "hello" > hello.txt
5:  $ git add .
6:  $ git commit -m 'initial'

2.3.2 Git clone 資料, 資料修改後上傳

1:  $ git clone http://git.example.com/project.git
2:  $ cd project
3:  $ touch new_file.txt
4:  $ git add .
5:  $ git commit -m 'add new_file.txt'
6:  $ git push origin master
7:  $ git pull # 拉看看有沒有更新

2.4 扩展应用

2.4.1 在 Google Code 中使用 Git

参见：http://linuxtoy.org/archives/google-code-git.html

2.5 安装

2.5.1 在 Linux 上安装

如果要在 Linux 上安装预编译好的 Git 二进制安装包，可以直接用系统提供的包管理工具。

在 Fedora 上用 yum 安装：

$ yum install git-core

在 Ubuntu 这类 Debian 体系的系统上，可以用 apt-get 安装：

$ apt-get instal git-core

2.5.2 在 Windows 上安装

在 Windows 上安装 Git 同样轻松，有个叫做 msysGit 的项目提供了安装包，可以从 Google Code 的页面上下载安装文件（.exe）：

http://code.google.com/p/msysgit

完成安装之后，就可以使用命令行的 git 工具（已经自带了 ssh 客户端）了，另外还有一个图形界面的 Git 项目管理工具。

2.5.3 在 Mac 上安装

在 Mac 上安装 Git 有两种方式。最容易的当属使用图形化的 Git 安装工具，界面如图 1-7，下载地址在：

http://code.google.com/p/git-osx-installer

另一种是通过 MacPorts (http://www.macports.org) 安装。如果已经装好了 MacPorts，用下面的命令安装 Git：

$ sudo port install git-core +svn +doc +bash_completion +gitweb

这种方式就不需要再自己安装依赖库了，Macports 会帮你搞定这些麻烦事。一般上面列出的安装选项已经够用，要是你想用 Git 连接 Subversion 的代码仓库，还可以加上 +svn 选项，具体将在第八章作介绍。

2.6 配置

Git 提供了一个叫做 git config 的工具（译注：实际是 git-config 命令，只不过可以通过 git 加一个名字来呼叫此命令。），专门用来配置或读取相应的工作环境变量。而正是由这些环境变量，决定了 Git 在各个环节的具体工作方式和行为。这些变量可以存放在以下三个不同的地方：

• /etc/gitconfig 文件 ：系统中对所有用户都普遍适用的配置。若使用 git config 时用 --system 选项，读写的就是这个文件。
• ~/.gitconfig 文件 ：用户目录下的配置文件只适用于该用户。若使用 git config 时用 --global 选项，读写的就是这个文件。
• 当前项目的 git 目录中的配置文件（也就是工作目录中的 .git/config 文件）：这里的配置仅仅针对当前项目有效。

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

2.6.1 用户信息

第一个要配置的是你个人的用户名称和电子邮件地址。这两条配置很重要，每次 Git 提交时都会引用这两条信息，说明是谁提交了更新，所以会随更新内容一起被永久纳入历史记录：

$ git config --global user.name "John Doe"
$ git config --global user.email johndoe@example.com

如果用了 --global 选项，那么更改的配置文件就是位于你用户主目录下的那个，以后你所有的项目都会默认使用这里配置的用户信息。如果要在某个特定的项目中使用其他名字或者电邮，只要去掉 --global 选项重新配置即可，新的设定保存在当前项目的 .git/config 文件里。

2.6.2 文本编辑器

接下来要设置的是默认使用的文本编辑器。Git 需要你输入一些额外消息的时候，会自动调用一个外部文本编辑器给你用。默认会使用操作系统指定的默认编辑器，一般可能会是 Vi 或者 Vim。如果你有其他偏好，比如 Emacs 的话，可以重新设置：

$ git config --global core.editor emacs

2.6.3 差异分析工具

还有一个比较常用的是，在解决合并冲突时使用哪种差异分析工具。比如要改用 vimdiff 的话：

$ git config --global merge.tool vimdiff

Git 可以理解 kdiff3，tkdiff，meld，xxdiff，emerge，vimdiff，gvimdiff，ecmerge，和 opendiff 等合并工具的输出信息。当然，你也可以指定使用自己开发的工具，具体怎么做可以参阅第七章。

2.6.4 查看配置信息

要检查已有的配置信息，可以使用 git config --list 命令：

$ git config --list
user.name=Scott Chacon
user.email=schacon@gmail.com
color.status=auto
color.branch=auto
color.interactive=auto
color.diff=auto
...

有时候会看到重复的变量名，那就说明它们来自不同的配置文件（比如 etc/gitconfig 和 ~.gitconfig），不过最终 Git 实际采用的是最后一个。

也可以直接查阅某个环境变量的设定，只要把特定的名字跟在后面即可，像这样：

$ git config user.name
Scott Chacon

2.7 获取帮助

想了解 Git 的各式工具该怎么用，可以阅读它们的使用帮助，方法有三：

$ git help <verb>
$ git <verb> --help
$ man git-<verb>

比如，要学习 config 命令可以怎么用，运行：

$ git help config

我们随时都可以浏览这些帮助信息而无需连网。不过，要是你觉得还不够，可以到 Frenode IRC 服务器（irc.freenode.net）上的 #git 或 #github 频道寻求他人帮助。这两个频道上总有着上百号人，大多都有着丰富的 git 知识，并且乐于助人。

2.8 常用指令

本篇参考 http://plog.longwin.com.tw/my_note-unix/2009/05/19/git-learn-initial-command-2009

2.8.1 Git 新增檔案

$ git add . # 將資料先暫存到 staging area, add 之後再新增的資料, 於此次 commit 不會含在裡面.
$ git add filename
$ git add modify-file # 修改過的檔案, 也要 add. (不然 commit 要加上 -a 的參數)
$ git add -u # 只加修改過的檔案, 新增的檔案不加入.
$ git add -i # 進入互動模式

2.8.2 Git 刪除檔案

$ git rm filename

2.8.3 Git 修改檔名、搬移目錄

$ git mv filename new-filename

2.8.4 Git status 看目前的狀態

$ git status # 看目前檔案的狀態

2.8.5 Git Commit

$ git commit
$ git commit -m 'commit message'
$ git commit -a -m 'commit -message' # 將所有修改過得檔案都 commit, 但是 新增的檔案 還是得要先 add.
$ git commit -a -v # -v 可以看到檔案哪些內容有被更改, -a 把所有修改的檔案都 commit

2.8.6 Git 產生新的 branch

$ git branch # 列出目前有多少 branch
$ git branch new-branch # 產生新的 branch (名稱: new-branch), 若沒有特別指定, 會由目前所在的 branch / master 直接複製一份.
$ git branch new-branch master # 由 master 產生新的 branch(new-branch)
$ git branch new-branch v1 # 由 tag(v1) 產生新的 branch(new-branch)
$ git branch -d new-branch # 刪除 new-branch
$ git branch -D new-branch # 強制刪除 new-branch
$ git checkout -b new-branch test # 產生新的 branch, 並同時切換過去 new-branch
$ # 與 remote repository 有關
$ git branch -r # 列出所有 Repository branch
$ git branch -a # 列出所有 branch

2.8.7 Git checkout 切換 branch

$ git checkout branch-name # 切換到 branch-name
$ git checkout master # 切換到 master
$ git checkout -b new-branch master # 從 master 建立新的 new-branch, 並同時切換過去 new-branch
$ git checkout -b newbranch # 由現在的環境為基礎, 建立新的 branch
$ git checkout -b newbranch origin # 於 origin 的基礎, 建立新的 branch
$ git checkout filename # 還原檔案到 Repository 狀態
$ git checkout HEAD . # 將所有檔案都 checkout 出來(最後一次 commit 的版本), 注意, 若有修改的檔案都會被還原到上一版. (git checkout -f 亦可)
$ git checkout xxxx . # 將所有檔案都 checkout 出來(xxxx commit 的版本, xxxx 是 commit 的編號前四碼), 注意, 若有修改的檔案都會被還原到上一版.
$ git checkout -- $ # 恢復到上一次 Commit 的狀態($ 改成檔名, 就可以只恢復那個檔案)

2.8.8 Git diff

$ git diff master # 與 Master 有哪些資料不同
$ git diff --cached # 比較 staging area 跟本來的 Repository
$ git diff tag1 tag2 # tag1, 與 tag2 的 diff
$ git diff tag1:file1 tag2:file2 # tag1, 與 tag2 的 file1, file2 的 diff
$ git diff # 比較 目前位置 與 staging area
$ git diff --cached # 比較 staging area 與 Repository 差異
$ git diff HEAD # 比較目前位置 與 Repository 差別
$ git diff new-branch # 比較目前位置 與 branch(new-branch) 的差別
$ git diff --stat

2.8.9 Git Tag

$ git tag v1 ebff # log 是 commit ebff810c461ad1924fc422fd1d01db23d858773b 的內容, 設定簡短好記得 Tag: v1
$ git tag 中文 ebff # tag 也可以下中文, 任何文字都可以
$ git tag -d 中文 # 把 tag=中文 刪掉

2.8.10 Git log

$ git log # 將所有 log 秀出
$ git log --all # 秀出所有的 log (含 branch)
$ git log -p # 將所有 log 和修改過得檔案內容列出
$ git log --stat --summary # 查每個版本間的更動檔案和行數
$ git log filename # 這個檔案的所有 log
$ git log directory # 這個目錄的所有 log
$ git log -S'foo()' # log 裡面有 foo() 這字串的.
$ git log --no-merges # 不要秀出 merge 的 log
$ git log --since="2 weeks ago" # 最後這 2週的 log
$ git log --pretty=oneline # 秀 log 的方式
$ git log --pretty=short # 秀 log 的方式
$ git log --pretty=format:'%h was %an, %ar, message: %s'
$ git log --pretty=format:'%h : %s' --graph # 會有簡單的文字圖形化, 分支等.
$ git log --pretty=format:'%h : %s' --topo-order --graph # 依照主分支排序
$ git log --pretty=format:'%h : %s' --date-order --graph # 依照時間排序

2.8.11 Git show

$ git show ebff # 查 log 是 commit ebff810c461ad1924fc422fd1d01db23d858773b 的內容
$ git show v1 # 查 tag:v1 的修改內容
$ git show v1:test.txt # 查 tag:v1 的 test.txt 檔案修改內容
$ git show HEAD # 此版本修改的資料
$ git show HEAD^ # 前一版修改的資料
$ git show HEAD^^ # 前前一版修改的資料
$ git show HEAD~4 # 前前前前一版修改的資料

2.8.12 Git reset 還原

$ git reset --hard HEAD # 還原到最前面
$ git reset --hard HEAD~3
$ git reset --soft HEAD~3
$ git reset HEAD filename # 從 staging area 狀態回到 unstaging 或 untracked (檔案內容並不會改變)

2.8.13 Git grep

$ git grep "te" v1 # 查 v1 是否有 "te" 的字串
$ git grep "te" # 查現在版本是否有 "te" 的字串

2.8.14 Git stash 暫存

$ git stash # 丟進暫存區
$ git stash list # 列出所有暫存區的資料
$ git stash pop # 取出最新的一筆, 並移除.
$ git stash apply # 取出最新的一筆 stash 暫存資料. 但是 stash 資料不移除
$ git stash clear # 把 stash 都清掉

2.8.15 Git merge 合併

$ git merge
$ git merge master
$ git merge new-branch
$ 下述轉載自: ihower 的 Git 版本控制系統(2) 開 branch 分支和操作遠端 repo.x

    $ Straight merge 預設的合併模式，會有全部的被合併的 branch commits 記錄加上一個 merge-commit，看線圖會有兩條 Parents 線，並保留所有 commit log。
    $ Squashed commit 壓縮成只有一個 merge-commit，不會有被合併的 log。SVN 的 merge 即是如此。
    $ cherry-pick 只合併指定的 commit
    $ rebase 變更 branch 的分支點：找到要合併的兩個 branch 的共同的祖先，然後先只用要被 merge 的 branch 來 commit 一遍，然後再用目前 branch 再 commit 上去。這方式僅適合還沒分享給別人的 local branch，因為等於砍掉重練 commit log。

指令操作

    $ git merge <branch_name> # 合併另一個 branch，若沒有 conflict 衝突會直接 commit。若需要解決衝突則會再多一個 commit。
    $ git merge --squash <branch_name> # 將另一個 branch 的 commit 合併為一筆，特別適合需要做實驗的 fixes bug 或 new feature，最後只留結果。合併完不會幫你先 commit。
    $ git cherry-pick 321d76f # 只合併特定其中一個 commit。如果要合併多個，可以加上 -n 指令就不會先幫你 commit，這樣可以多 pick幾個要合併的 commit，最後再 git commit 即可。

2.8.16 Git blame

$ git blame filename # 關於此檔案的所有 commit 紀錄

2.8.17 Git 還原已被刪除的檔案

$ git ls-files -d # 查看已刪除的檔案
$ git ls-files -d | xargs git checkout -- # 將已刪除的檔案還原

2.8.18 Git 維護

$ git gc # 整理前和整理後的差異, 可由: git count-objects 看到.
$ git fsck --full

2.8.19 Git revert 資料還原

$ git revert HEAD # 回到前一次 commit 的狀態
$ git revert HEAD^ # 回到前前一次 commit 的狀態
$ git reset HEAD filename # 從 staging area 狀態回到 unstaging 或 untracked (檔案內容並不會改變)
$ git checkout filename # 從 unstaging 狀態回到最初 Repository 的檔案(檔案內容變回修改前)

以下與 遠端 Repository 相關

2.8.20 Git remote 維護遠端檔案

$ git remote
$ git remote add new-branch http://git.example.com.tw/project.git # 增加遠端 Repository 的 branch(origin -> project)
$ git remote show # 秀出現在有多少 Repository
$ git remote rm new-branch # 刪掉
$ git remote update # 更新所有 Repository branch
$ git branch -r # 列出所有 Repository branch

2.8.21 抓取 / 切換 Repository 的 branch

$ git fetch origin
$ git checkout --track -b reps-branch origin/reps-branch # 抓取 reps-branch, 並將此 branch 建立於 local 的 reps-branch

2.8.22 刪除 Repository 的 branch

$ git push origin :heads/reps-branch

3 patch文件的结构

补丁头

补丁头是分别由—/+++开头的两行，用来表示要打补丁的文件。—开头表示旧文件，+++开头表示新文件。

一个补丁文件中的多个补丁

一个补丁文件中可能包含以—/+++开头的很多节，每一节用来打一个补丁。所以在一个补丁文件中可以包含好多个补丁。

块

块是补丁中要修改的地方。它通常由一部分不用修改的东西开始和结束。他们只是用来表示要修改的位置。他们通常以@@开始，结束于另一个块的开始或者一个新的补丁头。

块的缩进

块会缩进一列，而这一列是用来表示这一行是要增加还是要删除的。

块的第一列

+号表示这一行是要加上的。

-号表示这一行是要删除的。

没有加号也没有减号表示这里只是引用的而不需要修改。