编程语言
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