1. Git

1.1. Git是何方神圣?

Git是用C語言開發的分布版本控制系統。版本控制系統可以保留一個文件集合的歷史記錄，并能回滾文件集合到另一個狀態（歷史記錄狀態）。另一個狀態可以是不同的文件，也可以是不同的文件內容。舉個例子，你可以將文件集合轉換到兩天之前的狀態，或者你可以在生產代碼和實驗性質的代碼之間進行切換。文件集合往往被稱作是“源代碼”。在一個分布版本控制系統中，每個人都有一份完整的源代碼（包括源代碼所有的歷史記錄信息），而且可以對這個本地的數據進行操作。分布版本控制系統不需要一個集中式的代碼倉庫。

當你對本地的源代碼進行了修改，你可以標注他們跟下一個版本相關（將他們加到index中），然后提交到倉庫中來（commit）。Git保存了所有的版本信息，所以你可以轉換你的源代碼到任何的歷史版本。你可以對本地的倉庫進行代碼的提交，然后與其他的倉庫進行同步。你可以使用Git來進行倉庫的克隆（clone）操作，完整的復制一個已有的倉庫。倉庫的所有者可以通過push操作（推送變更到別處的倉庫）或者Pull操作（從別處的倉庫拉取變更）來同步變更。

Git支持分支功能（branch）。如果你想開發一個新的產品功能，你可以建立一個分支，對這個分支的進行修改，而不至于會影響到主支上的代碼。

Git提供了命令行工具；這個教程會使用命令行。你也可以找到圖形工具，譬如與Eclipse配套的EGit工具，但是這些都不會在這個教程中進行描述。

1.2. 重要的術語

表 1. Git 術語

1.3. 索引

Git 需要將代碼的變化顯示的與下一次提交進行關聯。舉個例子，如果你對一個文件繼續了修改，然后想將這些修改提交到下一次提交中，你必須將這個文件提交到索引中，通過git add file命令。這樣索引可以保存所有變化的快照。

新增的文件總是要顯示的添加到索引中來。對于那些之前已經提交過的文件，可以在commit命令中使用-a 選項達到提交到索引的目的。

2. 安裝

在Ubuntu上，你可以通過apt來安裝git命令行工具

sudo apt-get install git-core

對于其他的Linux版本，請查看相關的軟件包安裝工具使用方法
msysgit項目提供了Windows版本的Git，地址是http://code.google.com/p/msysgit/

3. 配置

你可以在.gitconfig文件中防止git的全局配置。文件位于用戶的home目錄。 上述已經提到每次提交都會保存作者和提交者的信息，這些信息都可以保存在全局配置中。

后續將會介紹配置用戶信息、高亮顯示和忽略特定的文件

3.1. 用戶信息

通過如下命令來配置用戶名和Email

# Configure the user which will be used by git
# Of course you should use your name
git config --global user.name "Example Surname"
# Same for the email address
git config --global user.email "your.email@gmail.com"
# Set default so that all changes are always pushed to the repository
git config --global push.default "matching"

獲取Git配置信息，執行以下命令：

git config --list

3.2. 高亮顯示

以下命令會為終端配置高亮

git config --global color.status auto
git config --global color.branch auto

3.3. 忽略特定的文件

可以配置Git忽略特定的文件或者是文件夾。這些配置都放在.gitignore文件中。這個文件可以存在于不同的文件夾中，可以包含不同的文件匹配模式。為了讓Git忽略bin文件夾，在主目錄下放置.gitignore文件，其中內容為bin。

同時Git也提供了全局的配置，core.excludesfile。

3.4. 使用.gitkeep來追蹤空的文件夾

Git會忽略空的文件夾。如果你想版本控制包括空文件夾，根據慣例會在空文件夾下放置.gitkeep文件。其實對文件名沒有特定的要求。一旦一個空文件夾下有文件后，這個文件夾就會在版本控制范圍內。

4. 開始操作Git

后續將通過一個典型的Git工作流來學習。在這個過程中，你會創建一些文件、創建一個本地的Git倉庫、提交你的文件到這個倉庫中。這之后，你會克隆一個倉庫、在倉庫之間通過pull和push操作來交換代碼的修改。注釋（以#開頭）解釋了命令的具體含義

讓我們打開命令行開始操作吧

4.1. 創建內容

下面創建一些文件，它們會被放到版本控制之中

#Switch to home
cd ~/
# Create a directory
mkdir ~/repo01
# Switch into it
cd repo01
# Create a new directory
mkdir datafiles
# Create a few files
touch test01
touch test02
touch test03
touch datafiles/data.txt
# Put a little text into the first file
ls >test01

4.2. 創建倉庫、添加文件和提交更改

每個Git倉庫都是放置在.git文件夾下.這個目錄包含了倉庫的所有歷史記錄，.git/config文件包含了倉庫的本地配置。
以下將會創建一個Git倉庫，添加文件倒倉庫的索引中，提交更改。

# Initialize the local Git repository
git init
# Add all (files and directories) to the Git repository
git add .
# Make a commit of your file to the local repository
git commit -m "Initial commit"
# Show the log file
git log

4.3. diff命令與commit更改

通過git diff命令，用戶可以查看更改。通過改變一個文件的內容，看看git diff命令輸出什么，然后提交這個更改到倉庫中

# Make some changes to the file
echo "This is a change" > test01
echo "and this is another change" > test02

# Check the changes via the diff command 
git diff

# Commit the changes, -a will commit changes for modified files
# but will not add automatically new files
git commit -a -m "These are new changes"

4.4. Status, Diff 和 Commit Log

下面會向你展示倉庫現有的狀態以及過往的提交歷史

# Make some changes in the file
echo "This is a new change" > test01
echo "and this is another new change" > test02

# See the current status of your repository 
# (which files are changed / new / deleted)
git status
# Show the differences between the uncommitted files 
# and the last commit in the current branch
git diff

# Add the changes to the index and commit
git add . && git commit -m "More chaanges - typo in the commit message"

# Show the history of commits in the current branch
git log
# This starts a nice graphical view of the changes
gitk --all

4.5. 更正提交的信息 - git amend

通過git amend命令，我們可以修改最后提交的的信息
上述的提交信息中存在錯誤，下面會修改這個錯誤

git commit --amend -m "More changes - now correct"

4.6. 刪除文件

如果你刪除了一個在版本控制之下的文件，那么使用git add .不會在索引中刪除這個文件。需要通過帶-a選項的git commit命令和-A選項的git add命令來完成

# Create a file and put it under version control
touch nonsense.txt
git add . && git commit -m "a new file has been created"
# Remove the file
rm nonsense.txt
# Try standard way of committing -> will not work
 git add . && git commit -m "a new file has been created"
# Now commit with the -a flag
git commit -a -m "File nonsense.txt is now removed"
# Alternatively you could add deleted files to the staging index via
git add -A . 
git commit -m "File nonsense.txt is now removed"

5. 遠端倉庫（remote repositories）

5.1. 設置一個遠端的Git倉庫

我們將創建一個遠端的Git倉庫。這個倉庫可以存儲在本地或者是網絡上。

遠端Git倉庫和標準的Git倉庫有如下差別：一個標準的Git倉庫包括了源代碼和歷史信息記錄。我們可以直接在這個基礎上修改代碼，因為它已經包含了一個工作副本。但是遠端倉庫沒有包括工作副本，只包括了歷史信息。可以使用--bare選項來創建一個這樣的倉庫。

為了方便起見，示例中的倉庫創建在本地文件系統上

# Switch to the first repository
cd ~/repo01
# 
git clone --bare . ../remote-repository.git
# Check the content, it is identical to the .git directory in repo01
ls ~/remote-repository.git

5.2. 推送更改到其他的倉庫

做一些更改，然后將這些更改從你的第一個倉庫推送到一個遠端倉庫

# Make some changes in the first repository
cd ~/repo01
# Make some changes in the file
echo "Hello, hello. Turn your radio on" > test01
echo "Bye, bye. Turn your radio off" > test02

# Commit the changes, -a will commit changes for modified files
# but will not add automatically new files
git commit -a -m "Some changes"

# Push the changes
git push ../remote-repository.git

5.3. 添加遠端倉庫

除了通過完整的URL來訪問Git倉庫外，還可以通過git remote add命令為倉庫添加一個短名稱。當你克隆了一個倉庫以后，origin表示所克隆的原始倉庫。即使我們從零開始，這個名稱也存在。

# Add ../remote-repository.git with the name origin
git remote add origin ../remote-repository.git 

# Again some changes
echo "I added a remote repo" > test02
# Commit
git commit -a -m "This is a test for the new remote origin"
# If you do not label a repository it will push to origin
git push origin

5.4. 顯示已有的遠端倉庫

通過以下命令查看已經存在的遠端倉庫

# Show the existing defined remote repositories
git remote

5.5. 克隆倉庫

通過以下命令在新的目錄下創建一個新的倉庫

# Switch to home
cd ~
# Make new directory
mkdir repo02

# Switch to new directory
cd ~/repo02

# Clone
git clone ../remote-repository.git .

5.6. 拉?。≒ull）更改

通過拉取，可以從其他的倉庫中獲取最新的更改。在第二個倉庫中，做一些更改，然后將更改推送到遠端的倉庫中。然后第一個倉庫拉取這些更改

# Switch to home
cd ~

# Switch to second directory
cd ~/repo02
# Make changes
echo "A change" > test01
# Commit
git commit -a -m "A change"
# Push changes to remote repository
# Origin is automatically maintained as we cloned from this repository
git push origin
# Switch to the first repository and pull in the changes
cd ~/repo01
git pull ../remote-repository.git/
# Check the changes
less test01

6. 還原更改

如果在你的工作副本中，你創建了不想被提交的文件，你可以丟棄它。

# Create a new file with content
touch test04
echo "this is trash" > test04

# Make a dry-run to see what would happen
# -n is the same as --dry-run 
git clean -n

# Now delete
git clean -f

你可以提取老版本的代碼，通過提交的ID。git log命令可以查看提交ID

# Switch to home
cd ~/repo01
# Get the log
git log

# Copy one of the older commits and checkout the older revision via 

//譯者注：checkout 后加commit id就是把commit的內容復制到index和工作副本中 
git checkout commit_name

如果你還未把更改加入到索引中，你也可以直接還原所有的更改

#Some nonsense change
echo "nonsense change" > test01
# Not added to the staging index. Therefore we can 
# just checkout the old version
#譯者注：checkout后如果沒有commit id號，就是從index中拷貝數據到工作副本，不涉及commit部分的改變
git checkout test01
# Check the result
cat test01
# Another nonsense change
echo "another nonsense change" > test01
# We add the file to the staging index
git add test01
# Restore the file in the staging index
#譯者注：復制HEAD所指commit的test01文件到index中
git reset HEAD test01
# Get the old version from the staging index
#譯者注：復制index中test01到工作副本中git checkout test01
#譯者注，以上兩條命令可以合并為git checkout HEAD test01

也可以通過revert命令進行還原操作

# Revert a commit
git revert commit_name

即使你刪除了一個未添加到索引和提交的文件，你也可以還原出這個文件

# Delete a file
rm test01
# Revert the deletion
git checkout test01

如果你已經添加一個文件到索引中，但是未提交。可以通過git reset file
命令將這個文件從索引中刪除

// Create a file
touch incorrect.txt
// Accidently add it to the index
git add .
// Remove it from the index
git reset incorrect.txt
// Delete the file
rm incorrect.txt

如果你刪除了文件夾且尚未提交，可以通過以下命令來恢復這個文件夾 。譯者注：即使已經提交，也可以還原

git checkout HEAD -- your_dir_to_restore

譯者注：checkout和reset這兩個命令的含義是不同的，可以參閱這篇文章http://marklodato.github.com/visual-git-guide/index-en.html

7. 標記

Git可以使用對歷史記錄中的任一版本進行標記。這樣在后續的版本中就能輕松的找到。一般來說，被用來標記某個發行的版本

可以通過git tag命令列出所有的標記，通過如下命令來創建一個標記和恢復到一個標記

git tag version1.6 -m 'version 1.6' 
git checkout <tag_name>

8. 分支、合并

8.1. 分支

通過分支，可以創造獨立的代碼副本。默認的分支叫master。Git消耗很少的資源就能創建分支。Git鼓勵開發人員多使用分支

下面的命令列出了所有的本地分支，當前所在的分支前帶有*號

git branch

如果你還想看到遠端倉庫的分支，可以使用下面的命令

git branch -a

可以通過下面的命令來創建一個新的分支

# Syntax: git branch <name> <hash>
# <hash> in the above is optional 
# if not specified the last commit will be used
# If specified the corresponding commit will be used
git branch testing
# Switch to your new branch
git checkout testing
# Some changes
echo "Cool new feature in this branch" > test01
git commit -a -m "new feature"
# Switch to the master branch
git checkout master
# Check that the content of test01 is the old one
cat test01

8.2. 合并

通過Merge我們可以合并兩個不同分支的結果。Merge通過所謂的三路合并來完成。分別來自兩個分支的最新commit和兩個分支的最新公共commit

可以通過如下的命令進行合并

# Syntax: git merge <branch-name>
git merge testing

一旦合并發生了沖突，Git會標志出來，開發人員需要手工的去解決這些沖突。解決沖突以后，就可以將文件添加到索引中，然后提交更改

8.3. 刪除分支

刪除分支的命令如下：

#Delete branch testing
git branch -d testing
# Check if branch has been deleted
git branch

8.4. 推送（push）一個分支到遠端倉庫

默認的，Git只會推送匹配的分支的遠端倉庫。這意味在使用git push命令默認推送你的分支之前，需要手工的推送一次這個分支。

# Push testing branch to remote repository
git push origin testing

# Switch to the testing branch
git checkout testing

# Some changes
echo "News for you" > test01
git commit -a -m "new feature in branch"

# Push all including branch
git push

通過這種方式，你可以確定哪些分支對于其他倉庫是可見的，而哪些只是本地的分支

9. 解決合并沖突

如果兩個不同的開發人員對同一個文件進行了修改，那么合并沖突就會發生。而Git沒有智能到自動解決合并兩個修改

在這一節中，我們會首先制造一個合并沖突，然后解決它，并應用到Git倉庫中

下面會產生一個合并沖突

# Switch to the first directory
cd ~/repo01
# Make changes
touch mergeconflict.txt
echo "Change in the first repository" > mergeconflict.txt
# Stage and commit
git add . && git commit -a -m "Will create merge conflict 1"

# Switch to the second directory
cd ~/repo02
# Make changes
touch mergeconflict.txt
echo "Change in the second repository" > mergeconflict.txt
# Stage and commit
git add . && git commit -a -m "Will create merge conflict 2"
# Push to the master repository
git push

# Now try to push from the first directory
# Switch to the first directory
cd ~/repo01
# Try to push --> you will get an error message
git push
# Get the changes
git pull origin master

Git將沖突放在收到影響的文件中，文件內容如下：

<<<<<<< HEAD
Change in the first repository
=======
Change in the second repository
>>>>>>> b29196692f5ebfd10d8a9ca1911c8b08127c85f8

上面部分是你的本地倉庫，下面部分是遠端倉庫?，F在編輯這個文件，然后commit更改。另外的，你可以使用git mergetool命令

# Either edit the file manually or use 
git mergetool
# You will be prompted to select which merge tool you want to use
# For example on Ubuntu you can use the tool "meld"
# After merging the changes manually, commit them
git commit -m "merged changes"

10. 變基（Rebase）

10.1. 在同一分支中應用Rebase Commit

通過rebase命令可以合并多個commit為一個。這樣用戶push更改到遠端倉庫的時候就可以先修改commit歷史

接下來我們將創建多個commit，然后再將它們rebase成一個commit

# Create a new file
touch rebase.txt

# Add it to git
git add . && git commit -m "rebase.txt added to index"

# Do some silly changes and commit
echo "content" >> rebase.txt
git add . && git commit -m "added content"
echo " more content" >> rebase.txt
git add . && git commit -m "added more content"
echo " more content" >> rebase.txt
git add . && git commit -m "added more content"
echo " more content" >> rebase.txt
git add . && git commit -m "added more content"
echo " more content" >> rebase.tx
tgit add . && git commit -m "added more content"
echo " more content" >> rebase.txt
git add . && git commit -m "added more content"

# Check the git log message
git log

我們合并最后的七個commit。你可以通過如下的命令交互的完成

git rebase -i HEAD~7

這個命令會打開編輯器讓你修改commit的信息或者 squash / fixup最后一個信息

Squash會合并commit信息而fixup會忽略commit信息（待理解）

10.2. Rebasing多個分支

你也可以對兩個分支進行rebase操作。如下所述，merge命令合并兩個分支的更改。rebase命令為一個分支的更改生成一個補丁，然后應用這個補丁到另一分支中

使用merge和rebase，最后的源代碼是一樣的，但是使用rebase產生的commit歷史更加的少，而且歷史記錄看上去更加的線性

# Create new branch 
git branch testing
# Checkout the branch
git checkout testing
# Make some changes
echo "This will be rebased to master" > test01
# Commit into testing branch
git commit -a -m "New feature in branch"
# Rebase the master
git rebase master

10.3.Rebase最佳實踐

在push更改到其他的Git倉庫之前，我們需要仔細檢查本地分支的commit歷史

在Git中，你可以使用本地的commit。開發人員可以利用這個功能方便的回滾本地的開發歷史。但是在push之前，需要觀察你的本地分支歷史，是否其中有些commit歷史對其他用戶來說是無關的

如果所有的commit歷史都跟同一個功能有關，很多情況下，你需要rebase這些commit歷史為一個commit歷史。

交互性的rebase主要就是做重寫commit歷史的任務。這樣做是安全的，因為commit還沒有被push到其它的倉庫。這意味著commit歷史只有在被push之前被修改

如果你修改然后push了一個已經在目標倉庫中存在的commit歷史，這看起來就像是你實現了一些別人已經實現的功能

11. 創建和應用補丁

一個補丁指的是一個包含對源代碼進行修改的文本文件。你可以將這個文件發送給某人，然后他就可以應用這個補丁到他的本地倉庫

下面會創建一個分支，對這個分支所一些修改，然后創建一個補丁，并應用這個補丁到master分支

# Create a new branch
git branch mybranch
# Use this new branch
git checkout mybranch
# Make some changes
touch test05
# Change some content in an existing file
echo "New content for test01" >test01
# Commit this to the branch
git add .
git commit -a -m "First commit in the branch"

# Create a patch --> git format-patch master
git format-patch origin/master
# This created patch 0001-First-commit-in-the-branch.patch

# Switch to the master
git checkout master

# Apply the patch
git apply 0001-First-commit-in-the-branch.patch
# Do your normal commit in the master 
git add .
git commit -a -m "Applied patch"
# Delete the patch 
rm 0001-First-commit-in-the-branch.patch

12. 定義同名命令

Git允許你設定你自己的Git命令。你可以給你自己常用的命令起一個縮寫命令，或者合并幾條命令道一個命令上來。

下面的例子中，定義了git add-commit 命令，這個命令合并了git add . -A和git commit -m命令。定義這個命令后，就可以使用git add-commit -m "message"了.

git config --global alias.add-commit '!git add . -A && git commit'

但是非常不幸，截止寫這篇文章之前，定義同名命令在msysGit中還沒有支持。同名命令不能以！開始。

13. 放棄跟蹤文件

有時候，你不希望某些文件或者文件夾被包含在Git倉庫中。但是如果你把它們加到.gitignore文件中以后，Git會停止跟蹤這個文件。但是它不會將這個文件從倉庫中刪除。這導致了文件或者文件夾的最后一個版本還是存在于倉庫中。為了取消跟蹤這些文件或者文件夾，你可以使用如下的命令

# Remove directory .metadata from git repo
git rm -r --cached .metadata
# Remove file test.txt from repo
git rm --cached test.txt

這樣做不會將這些文件從commit歷史中去掉。如果你想將這些文件從commit歷史中去掉，可以參考git filter-branch
命令

14. 其他有用的命令

下面列出了在日常工作中非常有用的Git命令
Table 2. 有用的Git命令

15. 安裝Git服務

如上所述，我們的操作不需要Git服務。我可以只使用文件系統或者是Git倉庫的提供者，像Github或Bitbucket。但是，有時候，擁有一個自己的服務是比較方便的，在ubuntu下安裝一個服務相對來說是比較容易的

確定你已經安裝了ssh

apt-get install ssh

如果你還沒有安裝Git服務，安裝它

sudo apt-get install git-core

添加一個名為git的用戶

sudo adduser git

然后使用git用戶進行登陸，創建一個空的倉庫

# Login to server
# to test use localhost
ssh git@IP_ADDRESS_OF_SERVER

# Create repository
git init --bare example.git

現在你就可以向遠端的倉庫提交變更了

mkdir gitexample
cd gitexample
git init
touch README
git add README
git commit -m 'first commit'
git remote add origin git@IP_ADDRESS_OF_SERVER:example.git
git push origin master

16. 在線的遠端倉庫

16.1. 克隆遠端倉庫

Git支持遠端的操作。Git支持多種的傳輸類型，Git自帶的協議就叫做git。下面的的命令通過git協議從克隆一個倉庫

git clone git@github.com:vogella/gitbook.git

同樣的，你可以通過http協議來克隆倉庫

# The following will clone via HTTP git clone 
http://vogella@github.com/vogella/gitbook.git

16.2. 添加遠端倉庫

如果你克隆了一個遠端倉庫，那么原先的倉庫就叫做origin

你可以push修改到origin中，通過 git push origin 命令
. 當然，push到一個遠端的倉庫需要對倉庫的寫權限

你可以通過git remote add name gitrepo命令添加多個倉庫。例如，你可以通過http協議再次添加之前clone過來的倉庫:

// Add the https protocol 
git remote add githttp https://vogella@github.com/vogella/gitbook.git

16.3. 通過http和代理服務器進行遠端操作

如果你的防火墻屏蔽了出http以外的所有協議，那么使用http協議來獲取倉庫是非常好的方法。

Git同樣支持通過代理服務器使用http協議。下面的Git命令會展示這一點。你可以為所有的程序設置代理服務器或者只是為Git服務提供。

下面的例子用到了環境變量

# Linux
export http_proxy=http://proxy:8080
# On Windows
# Set http_proxy=http://proxy:8080 
git clone http://dev.eclipse.org/git/org.eclipse.jface/org.eclipse.jface.snippets.git
# Push back to the origin using http
git push origin

下面的例子只是用到了Git的配置

// Set proxy for git globally 
git config --global http.proxy http://proxy:8080
// To check the proxy settings
git config --get http.proxy
// Just in case you need to you can also revoke the proxy settings
git config --global --unset http.proxy

17. Git服務提供商

除了假設自己的服務，你也可以使用Git服務提供商提供的服務。最流行的Git服務提供網站是GitHub和Bitbucket。它們都提供了有限制的免費服務

17.1. GitHub

可以通過 https://github.com/ 訪問GitHub. GitHub上所有的公開倉庫都是免費的。如果你想在上面使用私有的倉庫，那么就需要付費給GitHub

GitHub需要你創建ssh的公鑰私鑰。生成一份Ubuntu的公鑰私鑰可以訪問 ssh key creation in Ubuntu，Windows環境可以訪問msysgit ssh key generation.

在GitHub上創建一個賬戶和一個倉庫以后。你會收到如何將你的項目上傳到GitHUb的指南，其中的命令大致如下：

Global setup: 
Set up git 
git config --global user.name "Your Name" 
git config --global user.email your.email@gmail.com 

Next steps: 
mkdir gitbook 
cd gitbook 
git init 
touch README 
git add README 
git commit -m 'first commit' 
git remote add origin git@github.com:vogella/gitbook.git
git push -u origin master 

Existing Git Repo? 
cd existing_git_repo 
git remote add origin 
git@github.com:vogella/gitbook.git 
git push -u origin master 

17.2. Bitbucket

可以通過 https://bitbucket.org/ 訪問Bitbucket. Bitbucket 提供了無限制了公共倉庫和只能有五個人訪問的私有倉庫。如果你需要超過五個人訪問私有倉庫，就需要付費給Bitbucket

• Mac下從安裝Git到使用github進行版本控制(git命令/Xcode管理)
• github 圖文詳解
• Windows下Git的安裝與使用
• Eclipse中Git的安裝、配置、使用