一、前言
GitHub 作为时下最大的开源代码管理项目,广泛被工程和科研人员使用,本文主要介绍如何如何将自己的项目程序上传到 GitHub 上。
要上传本地项目到 GitHub 上,主要分为两步,第一步是
二、创建 SSH keys
首先登录 GitHub 官网并登录自己的帐号,点击右上角头像,显示
选择 settings,并选择 SSH and GPG keys,
![](https://file.jishuzhan.net/article/1713709639238946817/d4397a2bd5695cce9858f557e6227fce.webp)
点击 New SSH key,
![](https://file.jishuzhan.net/article/1713709639238946817/40c46a7350ee720a6d2415140e381ebb.webp)
此时需要我们设置一个 title 和 key,其中 title 可以随便取,但是 key 需要生成!
打开终端输入(这里 YOUR_EMAIL 为你注册 GitHub 帐号时的邮箱)
ssh-keygen -t rsa -C YOUR_EMAIL
中间会提示你输入内容,直接 enter 即可,不需要输入,结果如下
![](https://file.jishuzhan.net/article/1713709639238946817/38f156f06f7ecdef100e373ff73c7039.webp)
此时在 ~/.ssh 目录下会生存一个 id_rsa.pub 文件,其内容就是前面所需要的 Key,
![](https://file.jishuzhan.net/article/1713709639238946817/c6d0f8720f81fc6bca13f5fa23dbeac3.webp)
将其内容复制到 Key 中
![](https://file.jishuzhan.net/article/1713709639238946817/3316dfedf325ca37bf0e30b0386ca85a.webp)
点击 Add SSH key 就成功创建了 SSH Key
![](https://file.jishuzhan.net/article/1713709639238946817/13b1230662008b88e5efd7eae31947c7.webp)
接下来设置本地 git 的用户名和邮箱,终端输入
git config --global user.name "yourname"
git config --global user.email "email@email.com"
此时终端输入
ssh -T git@github.com
显示如下内容则表示成功连接 GitHub
![](https://file.jishuzhan.net/article/1713709639238946817/ed18ecb7bc1c58a01a8ab657db4e6f5a.webp)
如果连接不同,则终端输入
ssh-agent -s
ssh-add ~/.ssh/id_rsa
再重新连接,即可成功!
三、上传项目到 GitHub
接下来我们就可以往 GitHub 上传自己的项目了,首先进入 GitHub 主页
![](https://file.jishuzhan.net/article/1713709639238946817/15531b8abed30d6d839d17ed2e40c2b8.webp)
点击 + 号,输入项目名称并创建一个新的仓库
![](https://file.jishuzhan.net/article/1713709639238946817/cbff4bb04322438ccdb2292005681f93.webp)
![](https://file.jishuzhan.net/article/1713709639238946817/9b10bd36dc214dce8c8d7bff8873afa1.webp)
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
结果显示
![](https://file.jishuzhan.net/article/1713709639238946817/11a6d2d2fb886abc2c43ca2a3f6312b4.webp)
(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
结果显示
![](https://file.jishuzhan.net/article/1713709639238946817/747fcf5412f9bee92d25ffc9de2af9cf.webp)
至此,就通过终端命令将项目上传到 GitHub 上了,此时打开 GitHub 可以看到已经有项目了
![](https://file.jishuzhan.net/article/1713709639238946817/ea0d41dc1b85c1ccd91b3a42398888c4.webp)
接下来介绍如何通过 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
![](https://file.jishuzhan.net/article/1713709639238946817/dcedb2e9301ee7f5dd7ba4ae8519a7c4.webp)
此时 git 会检测到文件改动,接下来点击文件右边的 + 号
![](https://file.jishuzhan.net/article/1713709639238946817/2eae6899baf58bc33688df58e1c692ed.webp)
将需要上传的文件添加到暂存区
![](https://file.jishuzhan.net/article/1713709639238946817/3396ca17e1e3aaa2fbe95e05cff822be.webp)
然后在 Commit 上方输入一些修改的提示信息
![](https://file.jishuzhan.net/article/1713709639238946817/b1367700fe4068617ab702eacbb02c59.webp)
然后点击 Commit
![](https://file.jishuzhan.net/article/1713709639238946817/24c0edd1e1531d338631776293945d67.webp)
此时暂存库中内容已经修改成功,最后只需要将修改完成的内容上传到 GitHub 上,点击 Sync (或者点击)修改信息提示输入框右上方的三个点,选择 Pull, Push 栏目下的 Push to,然后选择要上传的仓库,同样可以上传到 GitHub 上
![](https://file.jishuzhan.net/article/1713709639238946817/add37df807c49f649833a12d4494ebc8.webp)
上图结果表明已经将修改后的项目上传到 GitHub上了,此时打开 GitHub 检查,可以看到
![](https://file.jishuzhan.net/article/1713709639238946817/d46bcd696e02a2d87a30bef3ce4c53cf.webp)
此时已经将修改的 hello 同步到 GitHub 上了,至此就成功将项目上传到 GitHub 上了!