「详细教程」使用git将本地项目上传至Github仓库（MacOS为例）网站首页 技术教程

「详细教程」使用git将本地项目上传至Github仓库（MacOS为例）

Meilinger_ 2024-08-12 12:01:03

简介「详细教程」使用git将本地项目上传至Github仓库（MacOS为例）

前言：最近需要将自己的代码开源至自己的Github仓库，然而发现并没有一键上传文件夹的选项，于是参考现有教程进行了实践，成功✌️以下是详细步骤。

Tips：在文章录用之后，小伙伴们可以选择将自己的代码开源，便于同行更加方便地开展学术研究。

步骤

准备工作：Github端
- 1. 注册 Github 账号
- 2. 新建 Github 仓库
准备工作：本地端
- 1. 安装 Git
- 2. 创建本地项目仓库
重磅！本地端&Github端联合操作
- 1. 配置 SSH 与 git config
- 2. 上传代码

准备工作：Github端

1. 注册 Github 账号

在 https://github.com/join 注册一个账号，已有账号的同学跳过本步骤。

2. 新建 Github 仓库

步骤一：登录Github网站，打开网址 https://github.com/，按照如下步骤操作：

在这里插入图片描述

步骤二：来到如下界面，填写相应信息，最后点击Create Repository完成Github新仓库的创建。

在这里插入图片描述

至此，Github端的准备工作就做好啦！接下来我们进入本地操作。

准备工作：本地端

1. 安装 Git

注：已安装Git的同学忽略此步骤。

在 https://git-scm.com/downloads 下载Git，Mac系统需要安装MacOS版本。

在这里插入图片描述

这里我使用第一种方法，即借助Homebrew来安装Git，所以第一步就是安装Homebrew.

步骤一：安装 homebrew。参考网址： https://brew.sh/

具体操作：打开Mac终端，运行以下命令：

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装成功界面：
在这里插入图片描述
步骤二：安装 Git。参考网址：https://git-scm.com/download/mac

具体操作：Mac终端继续运行以下命令：

brew install git

安装后，使用git --version命令查看Git版本，输出对应版本说明安装成功，对应界面如下：
在这里插入图片描述

2. 创建本地项目仓库

步骤一：在本地项目所在路径下打开终端，或使用cd pj_path命令将终端切换至本地项目所在路径，其中pj_path为本地项目所在路径，这里我的本地项目所在的绝对路径是/Users/meilinger/Desktop/ICB，ICB是我的本地项目名称。

步骤二：使用git init命令初始化本地仓库，该步骤执行后，本地项目的根目录下会出现一个名为.git的隐藏文件夹。（PS：使用快捷键Command + Shift + .三键可以查看隐藏文件）
在这里插入图片描述

重磅！本地端&Github端联合操作

前面的操作中，本地端和Github端均为准备工作，二者无先后之分，下面的才是重头戏～

1. 配置 SSH 与 git config

总揽：首先在本地生成SSH key（步骤一 ➡️ 步骤三），然后在Github官网将SSH key添加至SSH key列表中（步骤四）。

步骤一：在终端输入ssh-keygen -t rsa -C email_address命令，其中email_address为注册Github时使用的邮箱。（注意⚠️：如果Github绑定了多个邮箱，这里填写主邮箱。）回车，进入下一步骤。

步骤二：输入SSH key的生成路径。我这里将SSH key的保存路径设置为/Users/meilinger/.ssh/id_rsa_ICB，可以看到，为便于记忆，将本地项目名称ICB添加至路径结尾～注意：如果直接回车，SSH key将会保存至系统提供的默认路径中（这里我的默认生成路径地址为/Users/meilinger/.ssh/id_rsa）。如果当前路径下已经存在同名key，可以选择重写与否。回车，输入密码+回车+确认密码+回车。直接回车就是没有密码。

至此，SSH key已经生成啦～

在这里插入图片描述

步骤三：在终端执行命令pbcopy < ~/.ssh/id_rsa_demo.pub将SSH public key复制到剪切板，下图所示界面表示操作成功。

在这里插入图片描述

步骤四：回到Github官网，依次点击账号头像、Settings、SSH and GPG keys以及New SSH key，如图。
在这里插入图片描述

点击New SSH key后系统会自动跳转至以下界面。在本界面，分别填写Title和Key字段，这里Title字段我填充的是本地项目名称，Key字段就是我们刚刚在步骤三中使用命令pbcopy < ~/.ssh/id_rsa_demo.pub复制的SSH public key. 之后点击Add SSH key完成添加操作。

在这里插入图片描述

接下来回到终端，使用命令ssh -T git@github.com验证是否添加成功，若添加成功，会出现如下界面：

在这里插入图片描述

如果终端返回 Permission denied (publickey) 字段，说明上述SSH key没有添加成功。解决方法：在终端执行命令 ssh-add ~/.ssh/id_rsa_ICB，记得换成自己的SSH key所在路径。

步骤五：配置git config. 如下图所示，在终端中，依次输入命令：

git config --global user.name github_name
git config --global user.email github_email

其中，github_name 为 Github 账号对应的名称，github_email 为Github 账号中的主邮箱，即前述步骤中使用的邮箱。

在这里插入图片描述

2. 上传代码

首先：确保此时终端当前所在路径为本地项目所在路径，即.git隐藏文件夹的上级目录。

步骤一：执行命令git add .，将本地项目中的全部文件添加至git中，命令中.的含义就是“全部文件”。
步骤二：执行命令git commit -m "description"，添加项目的描述文字，命令中description就是自定义的描述文字。
步骤三：执行命令git remote add origin pj_ssh_path，其中pj_ssh_path可通过下下图的方式进行复制粘贴，比如我这里的pj_ssh_path为git@github.com:meiling-fdu/ICB.git.

在这里插入图片描述

⚠️ PS：此步骤可能会报错“错误：远程 origin 已经存在。”，解决办法如图：

先执行命令 git remote rm origin删除已存在的远程配置，然后再执行上述命令 git remote add origin pj_ssh_path.
在这里插入图片描述

步骤四：执行命令git push -f origin master，将本地项目的文件上传至Github官网中。发现报错如下：

在这里插入图片描述

根据本篇博客的内容，我发现，是Github官网上邮箱设置的相关问题，即我们在邮箱设置页面中勾选了Keep my email addresses private与Block command line pushes that expose my email这两个选项，如下图所示：
在这里插入图片描述

所以第一个解决方法就是取消上述两个勾选☑️。但如果我们不想取消上述设置，可通过如下方法解决：

获取Github的推荐邮箱账号。可在邮箱设置页面中的如上图所示紫色下划线位置查看。可以看到我的推荐邮箱账号为73975898+meiling-fdu@users.noreply.github.com
执行命令git config --global user.email “推荐E-mail” 重置全局用户E-mail，这里的“推荐E-mail”即为上面的推荐邮箱账号。

在终端执行命令git config --global user.email，查看全局邮箱账号是否修改成功，由下图可知，全局邮箱账号已成功修改。
在这里插入图片描述