Github上传项目(超详细小白教程)

一、Github与Git

1.Git 是一个免费的开源分布式版本控制系统，你可以使用它来跟踪文件中的更改。你可以在 Git 中处理所有类型的项目。使用 Git，你可以将更改添加到代码中，然后在准备好时提交（或保存）它们。这意味着你还可以返回之前所做的更改。开发者常将 Git 与 GitHub 一起使用。

2.GitHub是一个基于git的代码托管平台，在github上可以建立仓库用于存放项目。GitHub 是一个免费的开源系统，所以我们可以在上面找到有用的资料，也可以保存自己做的一些开源项目，以供别人参考，当然GIthub也提供了付费的私人仓库，以供有人需要将一些不公开的项目放入云端仓库，而且Github还具有很好的代码管理能力。

二、git的下载安装

git是一个免费的软件可以直接去官网下载，这里把链接放到下面。
git官网: :https://git-scm.com/
跟着安装引导，全部点击下一步即可成功安装，我们需要git去管理Github。
如果安装没问题，用鼠标在桌面或文件夹任意地方右击可以看到出现两个带Git的选项。接下来我们主要使用的是Git Bash，也就是命令行工具进行Github的上传。
这里需要说明一下，git的默认编辑器是Vim编辑器，这是一个比较古老的编辑器，它的一些操作与我们现在使用的编辑器不一样，不过用熟练之后也有它自己的优势。在后续的使用过程中可能会出现一些误操作，在遇到的时候我会进行说明。

三、Github的注册

Github官网: https://www.csdn.net/
这是Github的官网，首先我们需要去官网注册一个账号，不过由于Github是一个国外的网站，所以我们需要一点魔法才能访问，这里大家可以去了解一下相关的方法。
克服这个困难之后，我们成功注册，注册的流程还是比较小白的，只需要按照要求去注册就要，注册的邮箱可以是国内的邮箱（QQ邮箱不可以），留一个常用的就好，方便日后的登录。
这里再说明一下，使用git的一个好处就是可以直接用内网上传项目，不需要登录Github。

四、Github的上传

1.GitHub的上传原理

如图所示，是Github上传的一个原理图，我们的电脑就是workspace，当我们执行add和commit命令后，项目文件会被推送到一个中间仓库，它既不在本地也不在Github远端仓库，可以用于临时保存文件。然后使用push命令，将文件推送到Github仓库管理，这时文件将被Github保存起来，可以随时拉取文件，所以我们主要做三步：第一，将项目文件加到缓冲区；第二，将文件提交到中间仓库；第三，将文件推送至Github。但是在这之前需要对本地仓库进行配置。

2.远程仓库的申请

首先我们需要创建一个远端仓库。
第一步：
进入个人主页后，找到这个加号。

第二步：
点击+号,选择新仓库 填写下面的内容
第三步：
点击最下方的创建仓库

这里仓库已经创建完毕，我们可以清楚的看到README文件、仓库名以及描述等等东西，但是这里我们需要注意两个地方，一个是左边的main，这是一个主分支的名字，过会关联的时候可能会遇到问题。main右边有个Branch他就是分支的意思，你既可以在这里直接创建分支，也可以使用git命令行在本地创建，但是我们先不要去创建。
如果说你在这里创建了分支，然后提交到了别的分支上，那么你的个人主页就不会显示提交的绿点，对于需要积累绿点的同学不是很友好，那么如果你不在乎这个，你可以去创建分支，然后提交到分支上。注意不管有多少个分支，主分支只有一个。

右边的部分是一个文件卡选项，这里可以获得我们一会需要的URL链接，或者是SSH链接。

3.本地仓库的关联

现在可以开始本地仓库的创建与关联了。
第一步：
找到一个专门管理Github仓库的地方，创建一个文件夹并命名，切记不要带汉字

第二步：
进入文件夹右击鼠标，点击Git Bush工具

弹出Vim编辑器的窗口，这里我们先讲解一下Vim的一些误触操作，不感兴趣的同学可以直接跳过，继续往后看。
Vim编辑器的一些操作：
_1.退出Vim编程界面：_有些同学刚开始摸索是会不小心进入Vim的编程界面，但是点什么地方都无法退出，像这样

事实上Vim有三种操作模式，我们这里只用第一种，所以不多展开。
那么我们只需要点击：shift+；(也就是 “：”)+q+enter,去退出这个界面，回到原来的界面即可。

_2.复制与粘贴：_Vim编辑器不能使用CTRL+C和CTRL+V去复制和粘贴，在后续使用的时候需要鼠标右击去进行复制和粘贴。

_3.退出Vim窗口:_退出的快捷键是CTRL+D，或者直接点击右上角X号。
_4.强制终止运行的代码：_后续我们在操作中会有点击ENTER之后运行卡住的情况，我们不用一直退出重新进入再重新输入，可以使用快捷键：CTRL+C，也就是cancle。
_5.使用上下方向键可以在屏幕上一直回溯执行的命令，再次点击ENTER或者修改后再执行都可以事半功倍。这里要注意Vim还是不支持鼠标去中间修改，需要使用键盘左右键去移动，可以灵活使用FN+方向键等快捷操作。
第三步：
输入git init ,进行初始化仓库，生成一个.git文件

git init

输出这个代表没问题，没有成功的话再输入运行一次。
第四步：
这时你的文件夹下面应该会显示一个.git文件夹，如果没有的话需要显示隐藏的文件夹。

打开这个文件夹，找到config文件
第五步： config文件配置
配置config文件就是给你一个名字，你以后提交的时候会显示自己的名字和邮箱，不配置的话会出问题。
这里有两种方法:(可以根据个人喜好，个人推荐直接改config文件)
方法1.更改config文件
接上步，双击用记事本打开config文件,现在是这样的

在后面加上这个

[user]
	name = yourname
	email = yourmail@XXX.com

然后保存文件
这里建议保存后隐藏掉.git文件。
方法2.直接在命令行输入

git config --global user.email "youraddress@company.com"

git config --global user.name "yourname"

注意不要抄错，然后回车执行。
第六步： 链接远端仓库
输入

git remote add origin 你的URL

URL从前文介绍的这里去复制
记得用鼠标去粘贴

输入运行之后窗口没有任何输出，这说明我们是对的。

但是这里还有一个很大的问题，如果我们不注意在后面提交的时候又会找半天问题。那就是分支的名字。

这里的名字竟然是master,我们还记得一开始我们创建的仓库里的唯一的分支名就是main，所以我们应该把文件提交到主分支上，还记得吗？这样减少出错的概率。
那么现在 ，我们已经关联好了仓库，我们在接下来的部分再解决这个问题。

4.项目的首次上传

第一步： 切换分支
1.输入下面的代码去查看分支

git branch -a

可以看到这里只有一个master分支，这显示不是我们要的
2.我们输入下面代码去拉取远端仓库

git fetch

这里显示一个new branch main

如果你显示这样

不要担心，这只是网络的问题，国内用魔法有时候网络不稳定链接不到远端，你可以休息一会再多拉取几次试试
3. 切换分支
输入下面代码去切换分支

git checkout main

这里显示分支成功切换，切换成功后会在现在的文件夹中显示一个README文件，这就是你远程仓库里的文件
第二步： 添加文件
在电脑将你需要上传的文件拖到已经建好的本地仓库文件夹中，初次上传我们可以先传一个。

输入

git add .

点的前面要加入一个空格，这代表将现在文件夹下的所有问价加入缓存区。
你也可以使用git add 加此文件夹下的具体文件名去只加入一个文件。

git add file.c

同样没有任何输出，这代表你没问题。
我们也可以使用

git status

去随时查看现在的状态，避免出错

new file，这表示非常好，我们已经成功加入了一个文件。
第二步： 提交文件
输入

git commit -m "这是你的提交说明"

这个显示我们已经提交成功了。

第四步： 推送到远端仓库
我们在第一次推送时需要多输一些代码，之后的推送可以直接使用:
git push 就可以，也十分方便。

第一次推送时：
输入

git push -u origin main

输出这个就显示成功了，那么你成功了吗？在评论区晒一晒呀！

我们打开Github刷新一下仓库看看

可以可以看到我们的文件已经出现在了仓库，这表示我们成功了。

5.上传时的常见错误

如果你按照我的做法去做的话，应该可以避开大部分的坑，但是每个人踩得坑都不一样，如果你有什么不懂的也可以评论区或者私信给我，我会尽量帮你解决问题。

其实除了这种命令行的方式，Github也提供了自己的上传方式，以及Git的GUI也就是图形操作界面的方式去上传项目文件，但是我觉得如果你想互联网相关的工作的话，我还是建议你使用命令行去操作，如果大家对别的上传方法感兴趣的话请大家在评论区多多留言，大家如果我也会写一篇文章分享其他的上传方法。
那么希望我的分享能给大家带来帮助，更加欢迎大家在评论区多多交流。