如何将本地项目托管到 Github

使用 Github 时，通常情况下，我们是先登录 Github ，新建一个版本库，然后在本地 git clone。

然而，也有一些情况，最初我们可能并不想将项目上传到 Github 做版本管理，只在自己电脑上 Coding ，但是后来我们改变注意了，想要把代码上传到 Github，这时候怎么办呢。换句话说，我们怎样把本地计算机中正在进行或者已经完成的项目托管到Github上？

一种方法是你可以先在 Github 上新建版本库，然后 git clone 到本地，将你的项目中的代码复制到本地版本库中，再 commit 、push， 这种方法比较简单，但是如果你希望在 Github 中的版本库的名字和你本地已有的名字一样，且 git clone 到相同的路径，则必须先将你本地的项目文件夹重命名，否则无法 git clone。

另一种方法，也是比较常用的方法，是先 git init 将本地代码文件夹版本化，并 commit ，再使用 git remote add <name> <url> 设置本地版本库的远端版本库地址，之后再 push 。 下面简单介绍一下。

---

Git、Github 的基本使用

首先需要在本地计算机中安装 Git，并申请 Github 账户，掌握 Git、Github 的基本使用。详细可以参考官方文档或者博主之前的博客GitHub入门笔记。

新建本地Git仓库

打开 Git bash 命令行窗口，cd 到你的项目文件夹，将项目初始化为 git 仓库：

git init

将项目内容加到仓库：

git add .

并提交到仓库：

git commit -m "初始化"

其中 -m 后面的内容是本地提交的注释。

在 Github 中新建仓库

进入你的 Github 主页，点击 Repositories 标签页下的 New ,新建一个代码仓库，填写仓库名字、描述等信息，并根据需要都选是否创建 README 文件。

将本地 Git 仓库上传到 Github

1. 在 Github 页面中，进入刚才新建的项目，获取项目的地址，在本地执行下面的命令，将本地仓库和 Github 中的仓库进行关联：

    git remote add origin <Github仓库地址>
   

2. 将本地仓库同步到Github中。这一步需要区分以下两种情况：

• 在Github中新建仓库时，没有选择创建 README 文件。 在本地 Git bash 中执行以下命令，即可将本地仓库同步到Github:

    git push -u origin master
  

  由于新建的远程仓库是空的，所以要加上 -u 这个参数。

• 在Github中新建仓库时，创建了 README 文件，此时需要将 Github 仓库中的 README.md 文件先合并到本地仓库：

    git pull --rebase origin master
  

  再将合并后的本地仓库同步到 Github 仓库:

    git push -u origin master
  

经过上面的步骤后，就可以将本地项目托管到 Github 上，之后便是尽情的 Coding 了。

---