GitHub项目上传教程：从入门到实践
GitHub项目上传教程：从入门到实践
本文将详细介绍如何在GitHub上上传项目，适合编程初学者。从Git和GitHub的基础概念开始，逐步讲解Git的安装、GitHub账号注册、项目上传的整个流程，并提供了详细的命令行操作指导和常见问题解决方案。
一、GitHub与Git
- Git 是一个免费的开源分布式版本控制系统，你可以使用它来跟踪文件中的更改。你可以在 Git 中处理所有类型的项目。使用 Git，你可以将更改添加到代码中，然后在准备好时提交（或保存）它们。这意味着你还可以返回之前所做的更改。开发者常将 Git 与 GitHub 一起使用。
- GitHub是一个基于git的代码托管平台，在github上可以建立仓库用于存放项目。GitHub 是一个免费的开源系统，所以我们可以在上面找到有用的资料，也可以保存自己做的一些开源项目，以供别人参考，当然GitHub也提供了付费的私人仓库，以供有人需要将一些不公开的项目放入云端仓库，而且GitHub还具有很好的代码管理能力。
二、Git的下载安装
Git是一个免费的软件可以直接去官网下载，这里把链接放到下面。
Git官网：https://git-scm.com/
跟着安装引导，全部点击下一步即可成功安装，我们需要Git去管理GitHub。
如果安装没问题，用鼠标在桌面或文件夹任意地方右击可以看到出现两个带Git的选项。接下来我们主要使用的是Git Bash，也就是命令行工具进行GitHub的上传。
这里需要说明一下，Git的默认编辑器是Vim编辑器，这是一个比较古老的编辑器，它的一些操作与我们现在使用的编辑器不一样，不过用熟练之后也有它自己的优势。在后续的使用过程中可能会出现一些误操作，在遇到的时候我会进行说明。
三、GitHub的注册
GitHub官网：https://github.com/
这是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也就是图形操作界面的方式去上传项目文件，但是我觉得如果你想互联网相关的工作的话，我还是建议你使用命令行去操作，如果大家对别的上传方法感兴趣的话请大家在评论区多多留言，大家如果我也会写一篇文章分享其他的上传方法。
那么希望我的分享能给大家带来帮助，更加欢迎大家在评论区多多交流。