github上手指南

新手跳过这一段，从此方括号后开始阅读

对于已经使用过GitHub的同学，要上传一个代码库按以下步骤：

1.在GitHub上创建一个repository；

2.在本地适当的文件夹运行git bash，在git bash中执行git clone，将该空repository拷贝下来，会产生一个相应的同名文件夹；

3.复制或cp要上传的代码到该clone出来的文件夹；

4.执行git add、git commit、git push上传。

对于已存在的代码，修改后传上去按一下步骤：

1.比如extract文件夹下有README.MD和readdxf文件夹，则先切换到readdxf文件夹： cd readdxf

2.执行 git add *， git commit -m "message"， git push origin master

】

参考：http://www.w3cschool.cc/w3cnote/git-guide.html

本人只是对上述教程进行自己的实践和稍微修改，帮助像我一样的新手更快上手。或者参考这里。

注册账户以及创建仓库

要想使用github第一步当然是注册github账号了， github官网地址：https://github.com/。之后就可以创建仓库了（免费用户只能建公共仓库），Create a New Repository，填好名称后Create，之后会出现一些仓库的配置信息，这也是一个git的简单教程。

Github 安装

下面我以git Windows版为例。安装完成后，点击Git Bash。

配置Git

首先在本地创建ssh key；

$ ssh-keygen -t rsa -C "[email protected]"

后面的[email protected]改为你在github上注册的邮箱，之后会要求确认路径和输入密码，我们这使用默认的一路回车就行。成功的话会在~/下生成.ssh文件夹，进去，打开id_rsa.pub，复制里面的key。

回到github上，进入 Account Settings（账户配置），左边选择SSH Keys，Add SSH Key,title随便填，粘贴在你电脑上生成的key。

为了验证是否成功，在git bash下输入：

$ ssh -T [email protected]

如果是第一次的会提示是否continue，输入yes就会看到：You've successfully authenticated, but GitHub does not provide shell access 。这就表示已成功连上github。

下面先设置username和email，因为github每次commit都会记录他们。

$ git config --global user.name "your name"
$ git config --global user.email "[email protected]"

下面有个问题需要说明。如果你是想把GitHub上项目clone下来，则直接创建新文件夹执行clone命令。会在该文件夹下生成一个.git文件夹和一个项目文件夹的。如果你是想把本地已有的项目传到GitHub上，则首先GitHub上肯定需要先创建一个项目的，可以为空（为空意思是连README文件都没有）；如果是空项目，你可以clone下来，把要传的东西拷到文件夹，然后push；把本地已有项目传到GitHub上更推荐的做法是，GitHub上新建一个项目，然后本地新建文件夹，执行init，然后把项目文件夹拷贝到该文件夹下，然后执行add，执行commit，执行push。

总结：一种方法是先clone那个项目下来，然后拷贝项目文件夹到clone创建的文件夹下。然后就可以add、commit、push了。另一种方法是创建一个新文件夹，然后init，然后拷贝项目文件夹到该文件夹下，然后add、commit、push。如果clone，就已经自动init了，不用再init。

创建新文件夹，打开，然后执行 git init 以创建新的 git 仓库。这个即为你要工作的目录。（如果是要将已有代码上传，这里可以先建文件夹，后面将要上传的文件夹拷贝过来）

在该文件夹上，右键git bash，添加远程地址：

$ git remote add origin [email protected]:yourName/yourRepo.git

后面的yourName和yourRepo表示你再github的用户名和刚才新建的仓库名。（加完之后进入.git，打开config，这里会多出一个remote "origin"内容，这就是刚才添加的远程地址，也可以直接修改config来配置远程地址。）

很容易把origin后面的地址写错，第一个命令是删除写错了的origin。后面是添加。

检出仓库

执行如下命令以创建一个本地仓库的克隆版本：

git clone /path/to/repository

其中/path/to/repository顾名思义即为代码库的URL地址。示例如下：

如果是远端服务器上的仓库，你的命令会是这个样子：

git clone username@host:/path/to/repository

这样其实就已经完成了。假如现在我们要把某个文件夹给传到这个代码仓库，步骤如下（夹杂一些概念的讲解）：

工作流

cd进入该文件夹，然后拷贝要传的东西到该文件夹。如 cp 要拷贝的文件夹 . -av （.表示当前目录，所以你要在那个文件夹下）

第二个命令自动忽略，当时按了TAB键，列出了UVaOJ目录下的文件。

你的本地仓库由 git 维护的三棵"树"组成。第一个是你的 工作目录，它持有实际文件；第二个是 暂存区（Index），它像个缓存区域，临时保存你的改动；最后是 HEAD，它指向你最后一次提交的结果。

你可以提出更改（把它们添加到暂存区），使用如下命令：
git add <filename>
git add *
这是 git 基本工作流程的第一步；使用如下命令以实际提交改动：
git commit -m "代码提交信息"
现在，你的改动已经提交到了 HEAD，但是还没到你的远端仓库。

推送改动

你的改动现在已经在本地仓库的 HEAD 中了。执行如下命令以将这些改动提交到远端仓库：
git push origin master
可以把 master 换成你想要推送的任何分支。

如果你还没有克隆现有仓库，并欲将你的仓库连接到某个远程服务器，你可以使用如下命令添加：
git remote add origin <server>
如此你就能够将你的改动推送到所添加的服务器上去了。

分支

分支是用来将特性开发绝缘开来的。在你创建仓库的时候，master 是"默认的"分支。在其他分支上进行开发，完成后再将它们合并到主分支上。

创建一个叫做"feature_x"的分支，并切换过去：
git checkout -b feature_x
切换回主分支：
git checkout master
再把新建的分支删掉：
git branch -d feature_x
除非你将分支推送到远端仓库，不然该分支就是不为他人所见的：
git push origin <branch>

更新与合并

要更新你的本地仓库至最新改动，执行：
git pull
以在你的工作目录中获取（fetch）并合并（merge）远端的改动。
要合并其他分支到你的当前分支（例如 master），执行：
git merge <branch>
在这两种情况下，git 都会尝试去自动合并改动。遗憾的是，这可能并非每次都成功，并可能出现冲突（conflicts）。这时候就需要你修改这些文件来手动合并这些冲突（conflicts）。改完之后，你需要执行如下命令以将它们标记为合并成功：
git add <filename>
在合并改动之前，你可以使用如下命令预览差异：
git diff <source_branch> <target_branch>

为软件发布创建标签是推荐的。这个概念早已存在，在 SVN 中也有。你可以执行如下命令创建一个叫做 1.0.0的标签：
git tag 1.0.0 1b2e1d63ff
1b2e1d63ff 是你想要标记的提交 ID 的前 10 位字符。可以使用下列命令获取提交 ID：
git log
你也可以使用少一点的提交 ID 前几位，只要它的指向具有唯一性。

替换本地改动

假如你操作失误（当然，这最好永远不要发生），你可以使用如下命令替换掉本地改动：
git checkout -- <filename>
此命令会使用 HEAD 中的最新内容替换掉你的工作目录中的文件。已添加到暂存区的改动以及新文件都不会受到影响。

假如你想丢弃你在本地的所有改动与提交，可以到服务器上获取最新的版本历史，并将你本地主分支指向它：
git fetch origin
git reset --hard origin/master

实用小贴士

内建的图形化 git：
gitk
彩色的 git 输出：
git config color.ui true
显示历史记录时，每个提交的信息只显示一行：
git config format.pretty oneline
交互式添加文件到暂存区：
git add -i