通过SSH方式将本地项目推送到Github的详细流程。

type

Post

status

Published

date

Aug 6, 2025

slug

summary

避免HTTP链接出错，使用SSH快速推送项目。

🎯 目标：

将你本地的项目通过 SSH 推送到 GitHub 的远程仓库，例如：

git@github.com:BolynWang/GeophysicsHub.git

🧱 前提条件

本地已安装 Git（终端输入 git --version 检查）

已有 GitHub 账号

本地已有项目文件夹

🪪 第一步：生成并配置 SSH 密钥（仅需做一次）

1.1 生成 SSH key（如果没有）

按提示一路回车，会生成：

私钥：~/.ssh/id_ed25519

公钥：~/.ssh/id_ed25519.pub

1.2 启动 SSH agent 并添加密钥

1.3 将 SSH 公钥添加到 GitHub

复制输出的内容，打开 GitHub：

点击头像 → Settings

左侧栏选择 SSH and GPG keys

点击 New SSH key

Title 随便写（如：My MacBook）
Key 粘贴你复制的内容
点击 Add SSH key

1.4 验证 SSH 是否连接成功

第一次连接时会提示是否信任，输入 yes。

成功会看到：

🗂️ 第二步：初始化本地仓库（如果还没做）

进入你的项目目录：

然后执行：

🚀 第三步：添加远程仓库并推送

3.1 添加 GitHub 上的远程仓库地址（使用 SSH 格式）

⚠️ 注意：需要先在 GitHub 上新建一个空仓库（不要添加README，避免冲突）

3.2 设置主分支为 main（如默认是 master）

3.3 推送到远程仓库

第一次推送后，以后就可以直接：

✅ 推送完成！

现在你的本地项目已经通过 SSH 推送到了 GitHub，你可以在浏览器中查看项目内容了。