GitHub入门指南-优快云博客

原文链接：GitHubHelp

安装Git(Linux环境)

如果你在查看该页，我们假定你对Git 以及GitHub都是陌生的。本指南将会给你讲解一些基本知识，以及使用流程的基本操作。

下载安装Git

GitHub的核心是一个开源的代码版本管理系统，Git*。它和Linux都是同一个团队创建。Git 负责GitHub上面一切与本地机器相关联的事情。加入你不知道Git是什么？点击请查看。

下载最新Git版本安装

下载链接：点击打开链接

提示：git和其他有图标的应用程序不同，它没有任何图标表示。

设置Git

安装好Git后，开始配置。打开一个Terminal客户端。

用户名

首先，应该注册一个用户名，作为你以后提交内容的标志。

$ git config --global user.name "Your Name Here"
# Sets the default name for git to use when you commit

邮箱

注册一个邮箱，Git将该邮箱将和你所提交内容使用的GitHub账户相关连。

$ git config --global user.email "your_email@example.com"
# Sets the default email for git to use when you commit

该邮箱必须和你的GitHub账户相关连，如果没关联，将该邮箱添加到你的GitHub账户里面，请参照该链接。若你想隐藏邮箱地址，请参照该链接。

保存密码

该项设置将保存你的远程服务器的用户名和密码，不需要每次都要输入验证。在使用该选项时，你应该开启凭证助手，git会将你的密码保存一段时间。

$ git config --global credential.helper cache
# Set git to use the credential memory cache

保存默认时间为15分钟，你可以参照一下步骤修改。

$ git config --global credential.helper 'cache --timeout=3600'
# Set the cache to timeout after 1 hour (setting is in seconds)

创建一个代码库

在GitHub上面创建一个新的代码库

每次你执行一个提交操作时，都是将内容保存在一个代码库里面（又称“回购”）。在你将工程放到 GitHub时，你需要先建立一个GitHub库。

点击新建库按钮

填写该页一些信息。当完成后，点击“Create Repository”按钮。

祝贺，你已经成功创建了第一个代码库。

为你的库创建一个README

对于GitHub库来收，虽然README并不是必须的，但是建议有。README文件主要描述你的工程信息，比如说，如何添加或者安装。你可可以添加联系信息----假如你的项目受欢迎，人们就想加入进来。

第一步：创建一个README文件

在下面的字符里面，输入如下代码：

$ mkdir ~/Hello-World
# Creates a directory for your project called "Hello-World" in your user directory

$ cd ~/Hello-World
# Changes the current working directory to your newly created directory

$ git init
# Sets up the necessary Git files
# Initialized empty Git repository in /Users/you/Hello-World/.git/

$ touch README
# Creates a file called "README" in your Hello-World directory

在你的Hello-World目录里面找到新建的README文件，打开输入“Hello world!”，保存。

第二步：提交README

写好README文件后，提交到GitHub上面。提交操作本质上是将你的工程文件在某个时间点的一个快照操作。

$ git add README
# Stages your README file, adding it to the list of files to be committed

$ git commit -m 'first commit'
# Commits your files, adding the message "first commit"

第三步：推送你的提交

到目前，你的所有操作都是在你的本地库里面，即你没有在GitHub上面做任何操作。链接你的本地库到GitHub帐号，你需要设置为你的库设置一个控制端，然后将你的提交推送到GitHub上面。

$ git remote add origin https://github.com/username/Hello-World.git
# Creates a remote named "origin" pointing at your GitHub repository

$ git push origin master
# Sends your commits in the "master" branch to GitHub

现在，你在GitHub上面查看你的库，你将会看到README已被添加进去。

庆祝

恭喜，你已经在GitHub上面创建了一个库，创建了一个README，提交，并且推送到GitHub上面，下面该做哪些操作呢？

分支一个库

给其他项目做提交

有时候，你想给其他项目做修改提交，或者用被人的项目作为自己的开始点。这种情况被叫做“分支”。该讲解中，将使用 Spoon-Knife 的工程作为列子。

第一步：分支Spoon-Knife的库

点击“Fork”按钮进行分支操作。

第二步：克隆你的分支

你已经成功克隆了spoon-Knife的库，但是，它只存在GitHub上面，为了能在工程上面操作，你需要将它克隆到本地机器上面。

运行一下命令：

$ git clone https://github.com/username/Spoon-Knife.git
# Clones your fork of the repository into the current directory in terminal

第三步：配置控制端

当一个库被克隆好，它有一个默认的遥控端“origin”指向你在GitHub的分支，并不是spoon-Knife的GitHub上的源库。为了跟踪spoon-Knife的GitHub上的源库，你需要另加一个遥控端“upstream”

$ cd Spoon-Knife
# Changes the active directory in the prompt to the newly cloned "Spoon-Knife" directory
$ git remote add upstream https://github.com/octocat/Spoon-Knife.git
# Assigns the original repository to a remote called "upstream"
$ git fetch upstream
# Pulls in changes not present in your local repository, without modifying your files

其他操作

你已经成功克隆了一个库，但是下面是一些更酷的操作：

推送提交

当你在一个分支上面完成了一些提交，想推送到你的分支工程上面，就像常规库的操作那样。

$ git push origin master
# Pushes commits to your remote repository stored on GitHub

获取上游库的变动

如果你的源库（如spoon-Knife库）更新，你可以添加这些更新到你自己的分支里面，运行一下代码：

$ git fetch upstream
# Fetches any new changes from the original repository
$ git merge upstream/master
# Merges any changes fetched into your working files