Git 本地项目上传 GitHub 指南:SSH 与 Token 认证方式
本文介绍了 Git 与 GitHub 的区别,详细讲解了将本地项目上传至 GitHub 的两种方法:SSH 认证和 Token 认证。内容包括创建仓库、生成密钥或令牌、初始化本地仓库、关联远程地址以及推送代码的步骤。文末总结了常用的 Git 命令,帮助开发者高效管理版本控制。

本文介绍了 Git 与 GitHub 的区别,详细讲解了将本地项目上传至 GitHub 的两种方法:SSH 认证和 Token 认证。内容包括创建仓库、生成密钥或令牌、初始化本地仓库、关联远程地址以及推送代码的步骤。文末总结了常用的 Git 命令,帮助开发者高效管理版本控制。

在学习如何将本地项目上传到 GitHub 之前,先来弄清楚 Git 和 GitHub 的区别以及它们之间的联系。
| 对比项 | Git | GitHub |
|---|---|---|
| 定义 | 分布式版本控制系统(DVCS),用于本地和远程管理代码版本 | 托管 Git 仓库的在线平台 |
| 作用 | 负责代码的版本管理,包括提交、回滚、分支管理等 | 允许用户在云端存储、协作和管理 Git 仓库 |
| 使用方式 | 在本地安装并使用 Git 命令行或 GUI 进行代码管理 | 通过浏览器或 Git 连接远程仓库,进行托管和协作 |
| 是否需要联网 | 不需要,可在本地使用 | 需要联网,用于远程仓库管理 |
| 是否依赖 GitHub | 不依赖,Git 可独立使用 | 依赖 Git,GitHub 是基于 Git 构建的 |
Git 是一个本地的版本控制工具,而 GitHub 是一个在线代码托管平台,GitHub 依赖 Git 进行版本控制,Git 也可以在本地独立使用,但通常两者结合使用以便于代码同步、协作和备份。
开始前,你需要:
- 安装 Git:未安装请参考相关官方文档或教程。
- 注册 GitHub 账号:GitHub 官网
Initialize this repository with a README,否则后续 git push 可能会遇到冲突。点击右上角的 +,选择 New repository(新建仓库)。


点击 Create repository 创建仓库。

在 Git Bash 终端输入以下命令(替换 [email protected] 为你的 GitHub 邮箱):
ssh-keygen -t rsa -b 4096 -C "[email protected]"
提示:执行后会提示你输入文件保存路径,直接回车即可(默认
~/.ssh/id_rsa)。然后会要求你输入密码,可直接回车跳过,接着会要求你再次输入密码进行确认,再次回车跳过即可。
复制输出的 SSH Key,并进入 GitHub SSH Key 管理页面,点击 New SSH Key。
运行以下命令复制 SSH Key:
cat ~/.ssh/id_rsa.pub
填写相关信息,最后点击 Add SSH key(添加 SSH 密钥)。
如果你的项目文件夹还未初始化 Git 仓库,可以执行以下命令:
cd /path/to/your/project # 进入你的项目目录
git init # 初始化 Git 仓库
这样,Git 就会在当前目录创建一个 .git 文件夹,代表该目录已成为一个 Git 仓库。
在 GitHub 创建仓库后,会看到类似以下的 git remote add 命令,请复制并在终端执行(替换为你的 GitHub 仓库地址):
git remote add origin [email protected]:your-username/your-repository.git
可以用以下命令检查远程仓库是否添加成功:
git remote -v
如果返回 origin 及对应的 GitHub 地址,则说明添加成功。
推送代码到指定分支:
git push -u origin main
确认推送分支,首次推送时,需要设置 main 或 master 分支:
# 确保主分支是 main(如果你的 GitHub 仓库默认是 master 则将 main 改为 master)
git branch -M main
提交代码,提交时需附带说明信息:
git commit -m "初次提交代码"
添加所有文件到 Git 版本控制,执行以下命令:
git add . # 或者添加特定文件,例如:git add main.py
进入 GitHub 个人访问令牌管理页面,点击 Generate new token。
复制个人访问令牌并保存好,下面会用到。点击 Generate token 生成 Token。
填写相关信息,如下图。
如果你的项目文件夹还未初始化 Git 仓库,可以执行以下命令:
cd /path/to/your/project # 进入你的项目目录
git init # 初始化 Git 仓库
这样,Git 就会在当前目录创建一个 .git 文件夹,代表该目录已成为一个 Git 仓库。
在 GitHub 创建仓库后,会看到类似以下的 git remote add 命令,请复制并在终端执行(替换为你的 GitHub 仓库地址):
git remote add origin https://github.com/your-username/your-repository.git
可以用以下命令检查远程仓库是否添加成功:
git remote -v
如果返回 origin 及对应的 GitHub 地址,则说明添加成功。
推送代码到指定分支:
git push -u origin main
确认推送分支,首次推送时,需要设置 main 或 master 分支:
# 确保主分支是 main(如果你的 GitHub 仓库默认是 master 则将 main 改为 master)
git branch -M main
提交代码,提交时需附带说明信息:
git commit -m "初次提交代码"
添加所有文件到 Git 版本控制,执行以下命令:
git add . # 或者添加特定文件,例如:git add main.py
当被要求输入凭证时,输入刚才复制的 Token。
在实际开发中,我们还需要掌握一些常见的 Git 命令,以提高 Git 版本控制的效率。
| 操作 | 命令 |
|---|---|
删除 .git 目录(重置仓库) | Remove-Item -Recurse -Force .git (Windows) / rm -rf .git (Linux/macOS) |
| 强制推送(覆盖远程) | git push --force |
| 初始化 Git 仓库 | git init |
| 添加远程仓库 | git remote add origin <仓库地址> |
| 克隆仓库 | git clone <仓库地址> |
| 查看当前状态 | git status |
| 查看提交历史 | git log --oneline --graph --decorate --all |
| 添加文件到暂存区 | git add . |
| 提交代码 | git commit -m "提交信息" |
| 推送代码到远程仓库 | git push -u origin main |
| 拉取远程最新代码 | git pull origin main |
| 创建新分支 | git checkout -b new-branch |
| 切换分支 | git checkout branch-name |
| 合并分支 | git merge branch-name |
| 删除本地分支 | git branch -d branch-name |
| 删除远程分支 | git push origin --delete branch-name |
撤销 git add | git reset HEAD file.txt |
| 撤销最近一次提交(保留更改) | git reset HEAD~1 |
| 撤销最近一次提交(删除更改) | git reset --hard HEAD~1 |
现在,您已经完全掌握了 Git 基本操作,并能顺利将代码上传到 GitHub!希望这篇教程能帮助您更好地使用 Git 进行版本控制。

微信公众号「极客日志」,在微信中扫描左侧二维码关注。展示文案:极客日志 zeeklog
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online
将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML 转 Markdown 互为补充。 在线工具,Markdown 转 HTML在线工具,online
将 HTML 片段转为 GitHub Flavored Markdown,支持标题、列表、链接、代码块与表格等;浏览器内处理,可链接预填。 在线工具,HTML 转 Markdown在线工具,online
通过删除不必要的空白来缩小和压缩JSON。 在线工具,JSON 压缩在线工具,online
将JSON字符串修饰为友好的可读格式。 在线工具,JSON美化和格式化在线工具,online