GitHub 项目提交完整流程（含常见问题与解决办法）

一、前提条件

1. 本地已安装 Git。
2. 已有 GitHub 账号。
3. 本地项目已经有代码（可以是新建的项目或已有项目）。

没有这些的可以看我之前的文章去配置

二、步骤一：生成 SSH Key（推荐国内稳定使用）

在 Git Bash 中执行：

ssh-keygen -t ed25519 -C "你的GitHub邮箱"

• 一路回车使用默认路径（~/.ssh/id_ed25519）
• passphrase 可以留空

生成结果：

• 私钥：id_ed25519（不要泄露！）
• 公钥：id_ed25519.pub

复制公钥到 GitHub

1. 打开 GitHub → Settings → SSH and GPG keys → New SSH key
2. Title：随便写，比如 VSCode
3. Key：打开公钥文件复制内容：

cat ~/.ssh/id_ed25519.pub

1. Add SSH key

三、步骤二：添加远程仓库（SSH over 443 推荐）

cd /你的项目目录
git init                # 如果本地还没有 git 仓库
git remote add origin ssh://git@ssh.github.com:443/你的用户名/仓库名.git

• ssh://git@ssh.github.com:443/... 使用 443 端口可以避免国内网络屏蔽 22 端口的问题

查看远程仓库是否成功：

git remote -v

输出应为：

origin  ssh://git@ssh.github.com:443/用户名/仓库名.git (fetch)
origin  ssh://git@ssh.github.com:443/用户名/仓库名.git (push)

四、步骤三：添加本地代码到 Git 并提交

git add .                     # 添加当前目录所有文件
git commit -m "第一次提交"     # 提交到本地仓库

• git status 可以随时查看修改状态

五、步骤四：加载 SSH Key 并推送

eval $(ssh-agent -s)          # 启动 SSH agent
ssh-add ~/.ssh/id_ed25519      # 添加私钥
ssh -T git@ssh.github.com -p 443  # 测试 SSH 连接

• 如果显示：

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

说明 SSH 配置成功。

推送到 GitHub：

git push -u origin master      # 如果本地分支是 master
# 或者 git push -u origin main

• -u 关联本地分支和远程分支，后续直接 git push 就行

六、常见错误与解决办法

七、后续更新项目流程

1. 修改代码后：

git add .
git commit -m "本次修改说明"

1. 推送到 GitHub：

git push

• 因为分支已经关联远程分支，直接 git push 即可

✅ 总结

• 国内用户推荐用 SSH over 443，稳定且不易被墙
• GitHub 不再支持账号密码推送，HTTPS 需要 PAT
• SSH Key 只需添加一次，以后无需每次输入密码
• 遇到问题时先用 git remote -v、git branch、git status 排查