GitHub 简明入门级教程

写在前面的话：

阅读本文之前请确保已经装好了git，并且已有github账号。
本文仅为入门级教程，没有详细的git命令说明，使用时还需查阅相关资料~

提示

安装了git之后别忘记配置用户名和邮箱哦，使用以下命令：

• 配置用户名：

git config --global user.name "youname"

• 配置邮箱：

git config --global  user.email "[e-mail]"

最后可以通过 git config -l 命令查看已配置的用户名和邮箱信息。

登陆github账号后，进行以下操作：

1.创建远程仓库：

登录github账号后，进入如下界面：

点击new repository开始创建仓库

填写好仓库的名称，设置权限(一般都为public，这样才能开源嘛~)
建议勾选最后一项，点击下面的Create repository按钮，这样github上的远程仓库就创建好了。

注意：创建好远程仓库后，需要将其URL(HTTPS/SSH)保存下来，因为后面要用到~

2.生成SSH key

ssh key 提供了一种与github通信的方式，可以在不输入密码的情况下，将github做为自己的remote服务器，从而进行版本控制。

步骤：

• 检查ssh是否存在
• 生成新的ssh key
• 将生成的ssh key添加到github中

明确了步骤之后，我们来一步步进行操作吧~
首先：使用以下命令来查看是否有.ssh文件夹。若有，则可以直接将ssh key添加到github中。

ls -al ~/.ssh

其次：若没有该文件，则进行第二步，生成ssh key。输入命令来生成ssh key

ssh-keygen -t rsa -C "[e-mail]"

此时去用户根目录下查看，会有.ssh的文件夹。

该文件夹下有两个文件：

id_rsa：私钥（不建议告诉别人哦~）
id_rsa.pub：公钥

最后：用编辑器打开id_rsa.pub文件，复制内容，在github的setting中，找到SSH and GPG keys目录，将复制的内容添加到SSH keys中就ok啦~

3.将本地代码push到github

cd到你的项目文件夹，使用git init命令，可以使当前文件夹变为可以通过git来管理的文件夹，举例子如下：

现在我们打开刚才创建的文件夹：

可以看到有一个隐藏的.git文件，这就说明该文件夹已经可以使用git来管理啦~

ok~现在我们可以在testgit2文件夹下创建要提交的文件，可以手动创建，也可以使用命令创建。
这里我们快速的用命令简单创建一下吧~

注意：

• git add [filename]：该命令是将文件添加到暂存区，暂存区的概念后面再解释。
• git commit -m "[string]"：该命令是将暂存区的文件提交到分支上。参数 -m 后面跟的字符串，是对提交文件的注释。

进行到这一步，我们一共做了两件事：

• 在github上创建remote repository。
• 在本地仓库完成了自己的项目代码。

上面的命令都是在本地进行操作，下面的操作才会和远程服务器打交道~
接下来终于要push代码了，将你本地完成的项目代码提交到github上~

于是你开心的在命令行使用了渴望已久的push命令~

git push origin master

结果~报错了o(╥﹏╥)o

别慌~先简单看一下错误：“请确保你有正确的权限并却仓库是否存在。”

为什么报错呢？ 有下面两个原因：

• 本地仓库和github仓库没有关联（重新remote）
• 生成的ssh key不对

解决方案：

• 关联本地仓库和远程仓库，使用下面命令(yourusername：你的远程仓库地址)

还记得刚创建远程仓库时你保存过的URL吗~~~要上场了

  git remote add origin [e-mail]:yourusername/tetsgit0.git

关联好之后，再次使用git push origin master命令，会发现提示以下信息：

出现这个问题的原因是，我们github创建的仓库中，有 README.md文件没有拉到本地

提示：初次pull代码到本地，需要先合并本地的项目和远程github的项目。因为我们远程仓库中的README.md文件本地没有，若是直接git pull origin master会报错：

所以pull之前加一句命令~

git pull origin master --allow-unrelated-histories

使用以上命令合并两个项目之后，再次git pull origin master，会有Already up to date的提示~

现在去我们本地仓库中，可以看到远程仓库中的README.md文件以及pull到本地了~
终于 到了最后一步，尽情的push你的代码到远程仓库吧~

git pull origin master

现在去github的仓库中就可以看到我们push的代码了~(^o^)/~