【Github系列（2）】如何通过Git插件上传本地Github项目（小白教程）

😭碎碎念：我个人比较健忘，既然写了第一篇博客，就顺便把我前几天学习的内容也顺便写上去吧。

🎯写在开头：希望我的博客内容能解决你的问题，祝你度过愉快的一天！😄😄😄

0 前言

本篇博客是在你已经有Git插件的基础上进行的，安装比较简单，具体可以参考如何在GitHub上传自己的项目（手把手教你上传完整教程）_github创建项目并上传-CSDN博客，

以下是使用 RSA方式生成 SSH Key 并上传项目到 GitHub 的完整步骤：

1 在github上创建一个仓库

登录你的github账号，然后按照下面的操作进行：

第一步：

第二步：

到此，前期工作就完成了🎇🎇🎇

2 生成 RSA SSH Key

2.1 打开 Git Bash

在 Windows 上，你可以通过开始菜单找到 Git Bash 并打开它。（一次运行一行代码，注意空格）

每次 Git 提交都会使用你的用户名和邮箱（是你的github登录邮箱哦），所以需要先配置，打开 Git Bash，输入以下命令：

git config --global user.name \"你的GitHub用户名\"git config --global user.email \"你的邮箱\"

可以使用以下命令查看当前 Git 配置：

git config --list

你会看到类似下面的内容：

2.2 生成新的 RSA SSH Key（如果你已经在本地有过环境配置，请直接跳转到4. 测试 SSH 连接）

在 Git Bash 中运行以下命令，生成新的 RSA SSH Key。将your_email@example.com替换为你的 GitHub 邮箱地址：

ssh-keygen -t rsa -b 4096 -C \"your_email@example.com\"

2.3 按提示操作

系统会提示你输入文件保存路径（默认是 ~/.ssh/id_rsa），直接按回车使用默认路径。接下来，系统会提示你输入一个密码（passphrase）。你可以输入一个密码以增加安全性，也可以直接按回车跳过。这里直接回车就行，我尝试了其他方法，但是并没有什么作用，考虑到创建的文件并不大，并且git可以访问全局，所以我就不再管。

这里直接回车跳过就可以

3 将公钥添加到 GitHub

3.1 复制公钥内容

在 Git Bash 中运行以下命令，将公钥内容复制到剪贴板：

cat ~/.ssh/id_rsa.pub

3.2 登录 GitHub

打开浏览器，登录到你的 GitHub 账户。

3.3 进入 SSH Keys 设置页面

点击右上角的头像，选择 Settings，然后在左侧菜单中选择 SSH and GPG keys。

3.4 添加新的 SSH Key

1. 点击 New SSH key 按钮。
2. 在 Title 字段中输入一个描述性的名称，例如 My Laptop。
3. 在 Key 字段中粘贴刚才复制的公钥内容。
4. 点击 Add SSH key 按钮。

4 测试 SSH 连接

4.1 启动 SSH Agent

在 Git Bash 中运行以下命令，启动 SSH Agent：

eval \"$(ssh-agent -s)\"

4.2 加载私钥

加载你刚才生成的私钥：

ssh-add ~/.ssh/id_rsa

4.3 测试连接

测试是否能通过 SSH 连接到 GitHub：

ssh -T git@github.com

如果一切正常，你会看到类似以下的输出：

Hi ! You\'ve successfully authenticated, but GitHub does not provide shell access.

5 创建或进入项目文件夹

5.1 进入用户目录

在 Git Bash 中，进入你的用户目录：

cd ~

5.2 创建项目文件夹

如果你还没有项目文件夹，可以创建一个。例如，创建一个名为 Git_project 的文件夹：

mkdir ~/Documents/Git_projectcd ~/Documents/Git_project

这里我是需要上传本地的项目，那么就直接进入本地文件就行：

cd ~/Desktop/Git_project(你对应的桌面文件夹)

这里要注意，你的路径每次都是绝对路径，也就是你必须包含~/Desktop/Git_project前面这一部分

5.3 初始化 Git 仓库

在项目文件夹中初始化 Git 仓库：

git init

6 配置远程仓库地址

6.1添加远程仓库地址

将你的本地仓库与 GitHub 仓库关联。确保使用 SSH 地址（这个创建github项目之后就会在Code界面出现）：

git remote add origin git@github.com:your_github_username/your_repo_name.git

这个SSH地址在这，你在github上创建项目完成会跳转到这里，注意：一定要选择SSH

7 添加文件并提交

7.1 添加文件到仓库

将你的项目文件添加到仓库中：

git add .

7.2 提交更改

提交你的更改：

git commit -m \"Initial commit\"

在这里你可能会遇到一些警告，不过没关系，正常忽略就可以了

8 推送代码到 GitHub

8.1 推送代码

将你的代码推送到 GitHub：

git push -u origin main

完结撒花🎇🎇🎇🎇，恭喜你，成功在github上上传了你的项目！开始你在github上的星辰大海吧！！！

9 上传数据集

Ps：在上传项目的过程中，我们经常遇到要上传数据集的情况，这里我单独提供一种方法：

把数据集打成 .zip 文件后，上传到 GitHub Releases 的附件里，别人直接点链接就能下载，而不用把整个数据集塞进仓库代码里。

9.1 操作步骤如下：

9.1.1 先把 datasets压缩成 datasets.zip（或分卷压缩）。

9.1.2 进 GitHub → 你的仓库 → Releases → Draft a new release。

9.1.3 填好 Tag（例如 v1.0.0）、标题、说明，然后把 datasets.zip 拖到 “Attach binaries” 区域。

9.1.4 点 Publish release。

9.1.5 发布后页面会生成形如：

https://github.com/你的用户名/你的仓库/releases/download/v1.0.0/datasets.zip

的直链，别人一点即可下载。

9.2 好处

主仓库体积很小，克隆快。

数据集可独立版本管理（换版本只需再发 Release）。

下载流量走 GitHub CDN，国内也能用工具加速。

9.3 注意

单文件≤ 2 GB（GitHub 限制）。

超过2 GB可拆卷或使用Git LFS / 网盘外链。

📚写在结尾：恭喜你，又看完了一篇博客，希望你今天过得开心😄😄😄🎶🎶🎶