GitHub如何上传项目(超详细小白教程)
GitHub如何上传项目(超详细小白教程)
目录
- 一、GitHub与Git
- 二、Git的下载安装
- 三、GitHub的注册
- 四、GitHub的上传
- 1.GitHub的上传原理
- 2.远程仓库的申请
- 3.本地仓库的关联
- 4.项目的首次上传
- 5.上传时的常见错误
一、GitHub与Git
Git 是一个免费的开源分布式版本控制系统，可以用来跟踪文件中的更改。它适用于所有类型的项目。使用 Git，可以将更改添加到代码中，然后在准备好时提交（或保存）它们。这意味着还可以返回之前所做的更改。开发者常将 Git 与 GitHub 一起使用。
GitHub是一个基于Git的代码托管平台，在GitHub上可以建立仓库用于存放项目。GitHub 是一个免费的开源系统，可以在上面找到有用的资料，也可以保存自己做的一些开源项目，以供别人参考。此外，GitHub还提供了付费的私人仓库，以供需要将一些不公开的项目放入云端仓库的用户使用。而且GitHub还具有很好的代码管理能力。
二、Git的下载安装
Git是一个免费的软件可以直接去官网下载，这里把链接放到下面。
Git官网：https://git-scm.com/
按照安装引导，全部点击下一步即可成功安装。安装完成后，可以在桌面或文件夹右击鼠标，可以看到出现两个带Git的选项。接下来主要使用的是Git Bash，也就是命令行工具进行GitHub的上传。
这里需要说明一下，Git的默认编辑器是Vim编辑器，这是一个比较古老的编辑器，它的一些操作与现在常用的编辑器不一样，不过用熟练之后也有它自己的优势。在后续的使用过程中可能会出现一些误操作，在遇到的时候会进行说明。
三、GitHub的注册
GitHub官网：https://github.com/
这是GitHub的官网，首先需要去官网注册一个账号，不过由于GitHub是一个国外的网站，所以需要一点魔法才能访问，可以去了解一下相关的方法。
克服这个困难之后，可以成功注册。注册的流程比较简单，只需要按照要求进行注册即可。注册的邮箱可以是国内的邮箱，留一个常用的就好，方便日后的登录。
这里再说明一下，使用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也就是图形操作界面的方式去上传项目文件，但是建议如果从事互联网相关的工作，还是使用命令行去操作。如果对别的上传方法感兴趣，可以留言，也会写一篇文章分享其他的上传方法。