GitHub详细教程

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

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

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

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

Git 术语

Git 需要将代码的变化显示的与下一次提交进行关联。举个例子，如果你对一个文件继续了修改，然后想将这些修改提交到下一次提交中，你必须将这个文件提交到索引中，通过git add file命令。这样索引可以保存所有变化的快照。

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

通过如下命令来配置用户名和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文件。其实对文件名没有特定的要求。一旦一个空文件夹下有文件后，这个文件夹就会在版本控制范围内。

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

<span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">Switch to home
</span><span style="color: rgb(176, 196, 222);">cd</span> ~/
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Create a directory
</span>mkdir ~/repo01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch into it
</span><span style="color: rgb(176, 196, 222);">cd</span> repo01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Create a new directory
</span>mkdir datafiles
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Create a few files
</span>touch test01
touch test02
touch test03
touch datafiles/data.txt
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Put a little text into the first file
</span>ls >test01

每个Git仓库都是放置在.git文件夹下.这个目录包含了仓库的所有历史记录，.git/config文件包含了仓库的本地配置。

以下将会创建一个Git仓库，添加文件倒仓库的索引中，提交更改。

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Initialize the local Git repository
</span>git init
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Add all (files and directories) to the Git repository
</span>git add .
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make a commit of your file to the local repository
</span>git commit -m <span style="color: rgb(255, 160, 122);">"Initial commit"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Show the log file
</span>git log

通过git diff命令，用户可以查看更改。通过改变一个文件的内容，看看gitdiff命令输出什么，然后提交这个更改到仓库中

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make some changes to the file
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"This is a change"</span> > test01
<span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"and this is another change"</span> > test02

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Check the changes via the diff command 
</span>git diff

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Commit the changes, -a will commit changes for modified files
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">but will not add automatically new files
</span>git commit -a -m <span style="color: rgb(255, 160, 122);">"These are new changes"</span>

下面会向你展示仓库现有的状态以及过往的提交历史

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make some changes in the file
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"This is a new change"</span> > test01
<span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"and this is another new change"</span> > test02

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">See the current status of your repository 
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">(which files are changed / new / deleted)
</span>git status
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Show the differences between the uncommitted files 
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">and the last commit in the current branch
</span>git diff

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Add the changes to the index and commit
</span>git add . && git commit -m <span style="color: rgb(255, 160, 122);">"More chaanges - typo in the commit message"</span>

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Show the history of commits in the current branch
</span>git log
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">This starts a nice graphical view of the changes
</span>gitk --all

通过git amend命令，我们可以修改最后提交的的信息。上述的提交信息中存在错误，下面会修改这个错误。

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

如果你删除了一个在版本控制之下的文件，那么使用git add .不会在索引中删除这个文件。需要通过带-a选项的git commit命令和-A选项的git add命令来完成

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Create a file and put it under version control
</span>touch nonsense.txt
git add . && git commit -m <span style="color: rgb(255, 160, 122);">"a new file has been created"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Remove the file
</span>rm nonsense.txt
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Try standard way of committing -> will not work 
</span>git add . && git commit -m <span style="color: rgb(255, 160, 122);">"a new file has been created"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Now commit with the -a flag
</span>git commit -a -m <span style="color: rgb(255, 160, 122);">"File nonsense.txt is now removed"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Alternatively you could add deleted files to the staging index via
</span>git add -A . 
git commit -m <span style="color: rgb(255, 160, 122);">"File nonsense.txt is now removed"</span>

我们将创建一个远端的Git仓库。这个仓库可以存储在本地或者是网络上。

远端Git仓库和标准的Git仓库有如下差别：一个标准的Git仓库包括了源代码和历史信息记录。我们可以直接在这个基础上修改代码，因为它已经包含了一个工作副本。但是远端仓库没有包括工作副本，只包括了历史信息。可以使用–bare选项来创建一个这样的仓库。

为了方便起见，示例中的仓库创建在本地文件系统上

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to the first repository
</span><span style="color: rgb(176, 196, 222);">cd</span> ~/repo01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">
</span>git clone --bare . ../remote-repository.git

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Check the content, it is identical to the .git directory in repo01
</span>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表示所克隆的原始仓库。即使我们从零开始，这个名称也存在。

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Add ../remote-repository.git with the name origin
</span>git remote add origin ../remote-repository.git 

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Again some changes
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"I added a remote repo"</span> > test02
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Commit
</span>git commit -a -m <span style="color: rgb(255, 160, 122);">"This is a test for the new remote origin"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">If you do not label a repository it will push to origin
</span>git push origin

通过以下命令查看已经存在的远端仓库

# Show the existing defined remote repositories
git remote

通过以下命令在新的目录下创建一个新的仓库

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to home
</span><span style="color: rgb(176, 196, 222);">cd</span> ~
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make new directory
</span>mkdir repo02

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to new directory
</span>
<span style="color: rgb(176, 196, 222);">cd</span> ~/repo02
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Clone
</span>git clone ../remote-repository.git .

通过拉取，可以从其他的仓库中获取最新的更改。在第二个仓库中，做一些更改，然后将更改推送到远端的仓库中。然后第一个仓库拉取这些更改

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to home
</span><span style="color: rgb(176, 196, 222);">cd</span> ~

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to second directory
</span><span style="color: rgb(176, 196, 222);">cd</span> ~/repo02
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make changes
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"A change"</span> > test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Commit
</span>git commit -a -m <span style="color: rgb(255, 160, 122);">"A change"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Push changes to remote repository
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Origin is automatically maintained as we cloned from this repository
</span>git push origin
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to the first repository and pull in the changes
</span><span style="color: rgb(176, 196, 222);">cd</span> ~/repo01
git pull ../remote-repository.git/
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Check the changes
</span>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

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

<span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">Some nonsense change
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"nonsense change"</span> > test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Not added to the staging index. Therefore we can 
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">just checkout the old version
</span><span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">译者注：checkout后如果没有commit id号，就是从index中拷贝数据到工作副本，不涉及commit部分的改变
</span>git checkout test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Check the result
</span>cat test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Another nonsense change
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"another nonsense change"</span> > test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">We add the file to the staging index
</span>git add test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Restore the file in the staging index
</span><span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">译者注：复制HEAD所指commit的test01文件到index中
</span>git reset HEAD test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Get the old version from the staging index
</span><span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">译者注：复制index中test01到工作副本中
</span>git checkout test01
<span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">译者注，以上两条命令可以合并为git checkout HEAD test01
</span>
也可以通过revert命令进行还原操作 

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Revert a commit
</span>git revert commit_name

即使你删除了一个未添加到索引和提交的文件，你也可以还原出这个文件

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Delete a file
</span>rm test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Revert the deletion
</span>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同样支持通过代理服务器使用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

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

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

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

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

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

Git 术语

Git 需要将代码的变化显示的与下一次提交进行关联。举个例子，如果你对一个文件继续了修改，然后想将这些修改提交到下一次提交中，你必须将这个文件提交到索引中，通过git add file命令。这样索引可以保存所有变化的快照。

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

通过如下命令来配置用户名和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文件。其实对文件名没有特定的要求。一旦一个空文件夹下有文件后，这个文件夹就会在版本控制范围内。

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

<span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">Switch to home
</span><span style="color: rgb(176, 196, 222);">cd</span> ~/
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Create a directory
</span>mkdir ~/repo01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch into it
</span><span style="color: rgb(176, 196, 222);">cd</span> repo01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Create a new directory
</span>mkdir datafiles
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Create a few files
</span>touch test01
touch test02
touch test03
touch datafiles/data.txt
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Put a little text into the first file
</span>ls >test01

每个Git仓库都是放置在.git文件夹下.这个目录包含了仓库的所有历史记录，.git/config文件包含了仓库的本地配置。

以下将会创建一个Git仓库，添加文件倒仓库的索引中，提交更改。

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Initialize the local Git repository
</span>git init
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Add all (files and directories) to the Git repository
</span>git add .
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make a commit of your file to the local repository
</span>git commit -m <span style="color: rgb(255, 160, 122);">"Initial commit"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Show the log file
</span>git log

通过git diff命令，用户可以查看更改。通过改变一个文件的内容，看看gitdiff命令输出什么，然后提交这个更改到仓库中

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make some changes to the file
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"This is a change"</span> > test01
<span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"and this is another change"</span> > test02

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Check the changes via the diff command 
</span>git diff

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Commit the changes, -a will commit changes for modified files
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">but will not add automatically new files
</span>git commit -a -m <span style="color: rgb(255, 160, 122);">"These are new changes"</span>

下面会向你展示仓库现有的状态以及过往的提交历史

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make some changes in the file
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"This is a new change"</span> > test01
<span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"and this is another new change"</span> > test02

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">See the current status of your repository 
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">(which files are changed / new / deleted)
</span>git status
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Show the differences between the uncommitted files 
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">and the last commit in the current branch
</span>git diff

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Add the changes to the index and commit
</span>git add . && git commit -m <span style="color: rgb(255, 160, 122);">"More chaanges - typo in the commit message"</span>

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Show the history of commits in the current branch
</span>git log
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">This starts a nice graphical view of the changes
</span>gitk --all

通过git amend命令，我们可以修改最后提交的的信息。上述的提交信息中存在错误，下面会修改这个错误。

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

如果你删除了一个在版本控制之下的文件，那么使用git add .不会在索引中删除这个文件。需要通过带-a选项的git commit命令和-A选项的git add命令来完成

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Create a file and put it under version control
</span>touch nonsense.txt
git add . && git commit -m <span style="color: rgb(255, 160, 122);">"a new file has been created"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Remove the file
</span>rm nonsense.txt
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Try standard way of committing -> will not work 
</span>git add . && git commit -m <span style="color: rgb(255, 160, 122);">"a new file has been created"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Now commit with the -a flag
</span>git commit -a -m <span style="color: rgb(255, 160, 122);">"File nonsense.txt is now removed"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Alternatively you could add deleted files to the staging index via
</span>git add -A . 
git commit -m <span style="color: rgb(255, 160, 122);">"File nonsense.txt is now removed"</span>

我们将创建一个远端的Git仓库。这个仓库可以存储在本地或者是网络上。

远端Git仓库和标准的Git仓库有如下差别：一个标准的Git仓库包括了源代码和历史信息记录。我们可以直接在这个基础上修改代码，因为它已经包含了一个工作副本。但是远端仓库没有包括工作副本，只包括了历史信息。可以使用–bare选项来创建一个这样的仓库。

为了方便起见，示例中的仓库创建在本地文件系统上

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to the first repository
</span><span style="color: rgb(176, 196, 222);">cd</span> ~/repo01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">
</span>git clone --bare . ../remote-repository.git

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Check the content, it is identical to the .git directory in repo01
</span>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表示所克隆的原始仓库。即使我们从零开始，这个名称也存在。

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Add ../remote-repository.git with the name origin
</span>git remote add origin ../remote-repository.git 

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Again some changes
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"I added a remote repo"</span> > test02
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Commit
</span>git commit -a -m <span style="color: rgb(255, 160, 122);">"This is a test for the new remote origin"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">If you do not label a repository it will push to origin
</span>git push origin

通过以下命令查看已经存在的远端仓库

# Show the existing defined remote repositories
git remote

通过以下命令在新的目录下创建一个新的仓库

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to home
</span><span style="color: rgb(176, 196, 222);">cd</span> ~
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make new directory
</span>mkdir repo02

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to new directory
</span>
<span style="color: rgb(176, 196, 222);">cd</span> ~/repo02
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Clone
</span>git clone ../remote-repository.git .

通过拉取，可以从其他的仓库中获取最新的更改。在第二个仓库中，做一些更改，然后将更改推送到远端的仓库中。然后第一个仓库拉取这些更改

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to home
</span><span style="color: rgb(176, 196, 222);">cd</span> ~

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to second directory
</span><span style="color: rgb(176, 196, 222);">cd</span> ~/repo02
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Make changes
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"A change"</span> > test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Commit
</span>git commit -a -m <span style="color: rgb(255, 160, 122);">"A change"</span>
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Push changes to remote repository
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Origin is automatically maintained as we cloned from this repository
</span>git push origin
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Switch to the first repository and pull in the changes
</span><span style="color: rgb(176, 196, 222);">cd</span> ~/repo01
git pull ../remote-repository.git/
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Check the changes
</span>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

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

<span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">Some nonsense change
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"nonsense change"</span> > test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Not added to the staging index. Therefore we can 
</span><span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">just checkout the old version
</span><span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">译者注：checkout后如果没有commit id号，就是从index中拷贝数据到工作副本，不涉及commit部分的改变
</span>git checkout test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Check the result
</span>cat test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Another nonsense change
</span><span style="color: rgb(176, 196, 222);">echo</span> <span style="color: rgb(255, 160, 122);">"another nonsense change"</span> > test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">We add the file to the staging index
</span>git add test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Restore the file in the staging index
</span><span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">译者注：复制HEAD所指commit的test01文件到index中
</span>git reset HEAD test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Get the old version from the staging index
</span><span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">译者注：复制index中test01到工作副本中
</span>git checkout test01
<span style="color: rgb(255, 127, 36);">#</span><span style="color: rgb(255, 127, 36);">译者注，以上两条命令可以合并为git checkout HEAD test01
</span>
也可以通过revert命令进行还原操作 

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Revert a commit
</span>git revert commit_name

即使你删除了一个未添加到索引和提交的文件，你也可以还原出这个文件

<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Delete a file
</span>rm test01
<span style="color: rgb(255, 127, 36);"># </span><span style="color: rgb(255, 127, 36);">Revert the deletion
</span>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同样支持通过代理服务器使用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

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