GitHub具体教程

Git是用C语言开发的分布版本号控制系统。版本号控制系统能够保留一个文件集合的历史记录，并能回滚文件集合到还有一个状态（历史记录状态）。还有一个状态能够是不同的文件，也能够是不同的文件内容。举个样例，你能够将文件集合转换到两天之前的状态，或者你能够在生产代码和实验性质的代码之间进行切换。文件集合往往被称作是“源码”。在一个分布版本号控制系统中，每一个人都有一份完整的源码（包含源码全部的历史记录信息），并且能够对这个本地的数据进行操作。分布版本号控制系统不须要一个集中式的代码仓库。

当你对本地的源码进行了改动，你能够标注他们跟下一个版本号相关（将他们加到index中），然后提交到仓库中来（commit）。Git保存了全部的版本号信息，所以你能够转换你的源码到不论什么的历史版本号。你能够对本地的仓库进行代码的提交，然后与其它的仓库进行同步。你能够使用Git来进行仓库的克隆（clone）操作，完整的复制一个已有的仓库。仓库的全部者能够通过push操作（推送变更到别处的仓库）或者Pull操作（从别处的仓库拉取变更）来同步变更。

Git支持分支功能（branch）。假设你想开发一个新的产品功能，你能够建立一个分支，对这个分支的进行改动，而不至于会影响到主支上的代码。

Git提供了命令行工具；这个教程会使用命令行。你也能够找到图形工具，譬如与Eclipse配套的EGit工具，可是这些都不会在这个教程中进行描写叙述。

Git 术语

Git 须要将代码的变化显示的与下一次提交进行关联。举个样例，假设你对一个文件继续了改动，然后想将这些改动提交到下一次提交中，你必须将这个文件提交到索引中，通过git add file命令。这样索引能够保存全部变化的快照。

新增的文件总是要显示的加入?到索引中来。对于那些之前已经提交过的文件，能够在commit命令中使用-a 选项达到提交到索引的目的。

通过例如以下命令来配置username和Email

git config --global user.name "Example Surname"

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文件。事实上对文件名称没有特定的要求。一旦一个空目录下有文件后，这个目录就会在版本号控制范围内。

以下创建一些文件，它们会被放到版本号控制之中

#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命令，用户能够查看更改。通过改变一个文件的内容，看看gitdiff命令输出什么，然后提交这个更改到仓库中

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

我们将创建一个远端的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

做一些更改，然后将这些更改从你的第一个仓库推送到一个远端仓库 

cd ~/repo01

echo "Hello, hello. Turn your radio on" > test01echo "Bye, bye. Turn your radio off" > test02

git commit -a -m "Some 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

假设在你的工作副本中，你创建了不想被提交的文件，你能够丢弃它。

# 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 resetfile 命令将这个文件从索引中删除

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

Git能够使用对历史记录中的任一版本号进行标记。这样在兴许的版本号中就能轻松的找到。一般来说，被用来标记某个发行的版本号。能够通过git tag命令列出全部的标记，通过例如以下命令来创建一个标记和恢复到一个标记

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

通过分支，能够创造独立的代码副本。默认的分支叫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

通过这样的方式，你能够确定哪些分支对于其它仓库是可见的，而哪些仅仅是本地的分支

通过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历史，这看起来就像是你实现了一些别人已经实现的功能

一个补丁指的是一个包括对源码进行改动的文本文件。你能够将这个文件发送给某人，然后他就能够应用这个补丁到他的本地仓库。

以下会创建一个分支，对这个分支所一些改动，然后创建一个补丁，并应用这个补丁到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

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相同支持通过代理server使用http协议。以下的Git命令会展示这一点。你能够为全部的程序设置代理server或者仅仅是为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

能够通过 https://github.com/ 訪问GitHub. GitHub上全部的公开仓库都是免费的。假设你想在上面使用私有的仓库，那么就须要付费给GitHub

GitHub须要你创建ssh的公钥私钥。生成一份Ubuntu的公钥私钥能够訪问 sshkey 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