一、前言
GitHub 作为时下最大的开源代码管理项目,广泛被工程和科研人员使用,本文主要介绍如何如何将自己的项目程序上传到 GitHub 上。
要上传本地项目到 GitHub 上,主要分为两步,第一步是
二、创建 SSH keys
首先登录 GitHub 官网并登录自己的帐号,点击右上角头像,显示
选择 settings,并选择 SSH and GPG keys,
点击 New SSH key,
此时需要我们设置一个 title 和 key,其中 title 可以随便取,但是 key 需要生成!
打开终端输入(这里 YOUR_EMAIL 为你注册 GitHub 帐号时的邮箱)
ssh-keygen -t rsa -C YOUR_EMAIL
中间会提示你输入内容,直接 enter 即可,不需要输入,结果如下
此时在 ~/.ssh 目录下会生存一个 id_rsa.pub 文件,其内容就是前面所需要的 Key,
将其内容复制到 Key 中
点击 Add SSH key 就成功创建了 SSH Key
接下来设置本地 git 的用户名和邮箱,终端输入
git config --global user.name "yourname"
git config --global user.email "email@email.com"
此时终端输入
ssh -T git@github.com
显示如下内容则表示成功连接 GitHub
如果连接不同,则终端输入
ssh-agent -s
ssh-add ~/.ssh/id_rsa
再重新连接,即可成功!
三、上传项目到 GitHub
接下来我们就可以往 GitHub 上传自己的项目了,首先进入 GitHub 主页
点击 + 号,输入项目名称并创建一个新的仓库
3.1 终端方式上传项目到 GitHub
接下来就可以在终端进入需要上传的项目所在文件夹,并开始上传项目了
(1)如果是新创建的项目(没有 .git 文件),则终端输入
echo "# project_name" >> README.md
git init
git add README.md
git commit -m "first commit"
git branch -M master
git remote add origin git@github.com:xygxgn/project_name.git
git push -u origin master
结果显示
(2)如果是已经存在的项目(有 .git 文件),则终端输入
git remote add origin git@github.com:xygxgn/project_name.git
如果出现报错
fatal: remote origin already exists.
先查看远程仓库信息,终端输入
git remote -v
结果显示
origin git@github.com:xygxgn/project_name.git (fetch)
origin git@github.com:xygxgn/project_name.git (push)
只需删除已关联的远程仓库即可,终端输入
git remote remove origin
此时再输入 git remote -v 就显示没有远程仓库了,然和重新输入更新 GitHub 上项目的命令
git remote add origin git@github.com:xygxgn/project_name.git
然和选择分支并上传
git branch -M master
git push -u origin master
结果显示
至此,就通过终端命令将项目上传到 GitHub 上了,此时打开 GitHub 可以看到已经有项目了
接下来介绍如何通过 VSCode 来更新项目
3.2 VSCode 方式上传项目到 GitHub
首先在 VSCode 中 快捷键 ctrl + ` 打开终端,并输入
ssh -T git@github.com
结果显示
Hi xygxgn! You've successfully authenticated, but GitHub does not provide shell access.
接下来关联远程仓库
git remote add origin git@github.com:xygxgn/project_name.git
如果出现 remote origin already exists,则说明远程仓库已经关联,直接下一步即可
接下来点击需要上传的项目文件(如果目录下没有文件说明没有文件有所改动,可以随便修改一下其中一个文件),比如我这里修改了 README.md 文件,添加了一行 hello
此时 git 会检测到文件改动,接下来点击文件右边的 + 号
将需要上传的文件添加到暂存区
然后在 Commit 上方输入一些修改的提示信息
然后点击 Commit
此时暂存库中内容已经修改成功,最后只需要将修改完成的内容上传到 GitHub 上,点击 Sync (或者点击)修改信息提示输入框右上方的三个点,选择 Pull, Push 栏目下的 Push to,然后选择要上传的仓库,同样可以上传到 GitHub 上
上图结果表明已经将修改后的项目上传到 GitHub上了,此时打开 GitHub 检查,可以看到
此时已经将修改的 hello 同步到 GitHub 上了,至此就成功将项目上传到 GitHub 上了!