上传项目至GitHub的简单使用说明

1. • 首先你要在本地计算机中安装一个git客户端。

   • Git的简单使用
     第一步 下载Git for Windows
     1. 在官网点击Download，下载对应的exe文件，注意你的操作系统是32位还是64位。
     2. 双击安装，中间不用做任何改动，一直下一步就行。如果你想修改安装位置，请放在纯英文路径下。
     3. 安装成功，你现在就可以使用git命令行工具了。在你想要下载代码的路径，点击鼠标右键，选择Git Bash here。注意，你的代码路径也应是纯英文的。
     4. Git Bash使用的是MinGW.

     
     第二步 创建一个本地hello-world仓库
     1. 在命令行输入 mkdir hello-word，创建一个新文件夹。你可以使用ls命令来查看当前目录下有哪些文件和文件夹。
     2. 输入cd hello-world进入新文件夹，注意在输入命令时，你可以用Tab键来自动补全。
     3. 输入git init初始化Git仓库。此时用ls -a查看当前目录，可以看到多了一个.git/的文件夹，此文件夹保存了版本控制的所有相关信息。

   • 4. 输入echo "This is a simple practise" > readme.txt，创建一个readme.txt文件。
     5. 输入git status查看当前版本库状态，在Untracked files(未跟踪文件)下，会出现红色的readme.txt，代表此文件还未被Git所管理。
     6. 使用git add readme.txt，将该文件加入缓冲区，如果你确定所有的修改都需要提交，可以使用git add .来加入所有修改。现在用git status查看，将看到文件名变为绿色。
     7. 使用git commit -m "This is my first commit via Git!"来提交修改，-m后面所带的参数是本次提交信息，一般用来记录本次提交的主要意图。
     8. 提交成功后，可以用git log查看历史提交记录。每个记录都会有提交id，作者和提交日期。
     9. 你可以用git branch查看当前有哪些分支，当然，因为我们没有创建任何分支，目前只会有一个master分支。
     10. 使用git checkout -b feature创建一个名为feature的分支，再用git branch查看一下。

     你可以直接使用GitHub客户端，也可以用其他。

      

     右键启动Git Bash命令行

     如下图所示

     

   •  

     输入git  clone  接着将先前记录下来的地址复制到后面，回车

     

   • 将下载下来的项目文件夹的所有文件及文件夹，包括.git文件夹在内，全部拷贝到你的托管项目的根目录（或者将你的托管项目拷贝到该目录）

     cd test

     进入到该托管项目的根目录。

     

   • 输入 git add .    

     将改动的地方添加到版本管理器

     

   • 输入 git  commit -m "changes log"  

     提交到本地的版本控制库里，

     引号里面是你对本次提交的说明信息。

     

   • 最后输入

     git push  -u origin master 或直接 git push 

   • github的SSH Key的配置

             （1）   本地创建SSH key

                   ssh-keygen -t rsa -C "your_email@youremail.com"

                  一路回车，不需要输入。

               (2) 成功的话会在~/下生成.ssh文件夹，进去，复制id_rsa.pub文件内容

          (3)添加SSH   Key

            单击“Add SSH key”

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

               $ ssh -T git@github.com

         如果是第一次的会提示是否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 "your_email@youremail.com"

   • （以下未验证）
   • 接下来我们要做的就是把本地仓库传到github上去，

     进入要上传的仓库，右键git bash，添加远程地址：

     $ git remote add origin git@github.com:yourName/yourRepo.git

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

     创建新文件夹，打开，然后执行 git init 以创建新的 git 仓库。

   • 检出仓库

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

     git clone /path/to/repository 

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

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

     工作流

     你的本地仓库由 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

     链接与资源

     图形化客户端

   • GitX (L) (OSX, 开源软件)
   • Tower (OSX)
   • Source Tree (OSX, 免费)
   • GitHub for Mac (OSX, 免费)

   • 指南和手册

   • Git 社区参考书
   • 专业 Git
   • 像 git 那样思考
   • GitHub 帮助
   • 图解 Git

   • 相关文章

   • Github 简明指南：http://rogerdudler.github.io/git-guide/index.zh.html
   • 如何高效利用GitHub:http://www.yangzhiping.com/tech/github.html
   •  
   • GitBox (OSX, App Store)