Git 本地项目上传 GitHub 指南：SSH 与 Token 认证方式

点击 Create repository 创建仓库。

二、本地项目上传至 GitHub（方法一：使用 SSH 认证 | 推荐）

1. 生成 SSH 密钥

在 Git Bash 终端输入以下命令（替换 [email protected] 为你的 GitHub 邮箱）：

ssh-keygen -t rsa -b 4096 -C "[email protected]"

提示：执行后会提示你输入文件保存路径，直接回车即可（默认 ~/.ssh/id_rsa）。然后会要求你输入密码，可直接回车跳过，接着会要求你再次输入密码进行确认，再次回车跳过即可。

2. 添加 SSH Key 到 GitHub

复制输出的 SSH Key，并进入 GitHub SSH Key 管理页面，点击 New SSH Key。

运行以下命令复制 SSH Key：

cat ~/.ssh/id_rsa.pub 

填写相关信息，最后点击 Add SSH key（添加 SSH 密钥）。

3. 在本地初始化 Git 仓库

如果你的项目文件夹还未初始化 Git 仓库，可以执行以下命令：

cd /path/to/your/project # 进入你的项目目录
git init # 初始化 Git 仓库

这样，Git 就会在当前目录创建一个 .git 文件夹，代表该目录已成为一个 Git 仓库。

4. 关联远程仓库

在 GitHub 创建仓库后，会看到类似以下的 git remote add 命令，请复制并在终端执行（替换为你的 GitHub 仓库地址）：

git remote add origin [email protected]:your-username/your-repository.git 

可以用以下命令检查远程仓库是否添加成功：

git remote -v

如果返回 origin 及对应的 GitHub 地址，则说明添加成功。

5. 添加、提交和推送代码

1. 代码已成功推送至 GitHub 仓库，您可以前往 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（方法二：使用 Token 认证）

1. 生成 Personal Access Token (PAT)

进入 GitHub 个人访问令牌管理页面，点击 Generate new token。

复制个人访问令牌并保存好，下面会用到。点击 Generate token 生成 Token。

填写相关信息，如下图。

2. 在本地初始化 Git 仓库

如果你的项目文件夹还未初始化 Git 仓库，可以执行以下命令：

cd /path/to/your/project # 进入你的项目目录
git init # 初始化 Git 仓库

这样，Git 就会在当前目录创建一个 .git 文件夹，代表该目录已成为一个 Git 仓库。

3. 关联远程仓库

在 GitHub 创建仓库后，会看到类似以下的 git remote add 命令，请复制并在终端执行（替换为你的 GitHub 仓库地址）：

git remote add origin https://github.com/your-username/your-repository.git 

可以用以下命令检查远程仓库是否添加成功：

git remote -v

如果返回 origin 及对应的 GitHub 地址，则说明添加成功。

4. 添加、提交和推送代码

推送代码到指定分支：

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 版本控制的效率。

Git 常用命令总结

现在，您已经完全掌握了 Git 基本操作，并能顺利将代码上传到 GitHub！希望这篇教程能帮助您更好地使用 Git 进行版本控制。