Git使用詳解

1. Git

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

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

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

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

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

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

2. 安裝

sudo apt-get install git-core

3. 配置

通過如下命令來配置用戶名和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

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

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

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

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

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

4. 開始操作Git

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

#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

每個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

通過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"

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

# 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

通過git amend命令，我們可以修改最後提交的的信息

上述的提交信息中存在錯誤，下麵會修改這個錯誤

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

如果你刪除了一個在版本控製之下的文件，那麼使用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）

我們將創建一個遠端的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

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

# 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

除了通過完整的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

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

# Show the existing defined remote repositories
git remote

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

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

# Switch to new directory

cd ~/repo02
# Clone
git clone ../remote-repository.git .

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

# 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

# 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 a commit
git revert commit_name

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

// 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

7. 標記

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

8. 分支、合並

通過分支，可以創造獨立的代碼副本。默認的分支叫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

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

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

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

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

刪除分支的命令如下： 

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

默認的，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. 解決合並衝突

# 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

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

# 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）

通過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.txt
git 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信息（待理解）

你也可以對兩個分支進行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

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

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

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

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

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

11. 創建和應用補丁

# 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 config --global alias.add-commit '!git add . -A && git commit'

13. 放棄跟蹤文件

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

14. 其他有用的命令

Table 2. 有用的Git命令

15. 安裝Git服務

apt-get install ssh

sudo apt-get install git-core

sudo adduser 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. 在線的遠端倉庫

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

如果你克隆了一個遠端倉庫，那麼原先的倉庫就叫做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

如果你的防火牆屏蔽了出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服務提供商

可以通過 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
  

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

18. Git的圖形接口

19. 問題與討論

20. 鏈接和文章