GitHub 简明入门级教程

写在前面的话：

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

提示

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

• 配置用户名：

git config --global user.name "youname"

• 配置邮箱：

git config --global  user.email "youremail@email.com"

最后能够经过 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 "youemail@email.com"

此时去用户根目录下查看，会有.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 git@github.com: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^)/~