liang14658fox本地项目上传到 gitHub（SSH 方式）
一、前置条件
在开始之前，请确认：
- 已安装 git
- 已注册并登录 gitHub 账号
- 电脑系统为 macOS 或 Windows
- 当前项目未关联其他远程仓库
- 本地分支状态正常（无冲突）
- 已配置 SSH Key 并添加到 gitHub（如未配置，请参考下一节）
🔐 二、配置 git 与 SSH
1. 配置全局用户名与邮箱
bash
git config --global user.name "YourName"
git config --global user.email "your_email@example.com"git config --global user.name "YourName"
git config --global user.email "your_email@example.com"查看是否配置成功
sh
git config --global --listgit config --global --list2. 生成 SSH Key（如已存在可跳过）
sh
ssh-keygen -t rsa -b 4096 -C "your_email@example.com"ssh-keygen -t rsa -b 4096 -C "your_email@example.com"按提示一路回车，默认生成在如下目录
~/.ssh/id_rsa ~/.ssh/id_rsa.pub
查看并复制公钥内容：
sh
cat ~/.ssh/id_rsa.pubcat ~/.ssh/id_rsa.pub3. 在 gitHub 中添加 SSH Key
gitHub → Settings → SSH and GPG keys → New SSH key → 粘贴公钥 → Save
测试是否成功
sh
ssh -T git@gitHub.comssh -T git@gitHub.com若显示
sh
Hi username! You've successfully authenticated.Hi username! You've successfully authenticated.表示 SSH 配置成功
三、将本地代码上传到 gitHub
1. 在 gitHub 上创建新仓库
- 登录 gitHub → 点击右上角「+」→ New repository
- 填写仓库名
- 不勾选 “Initialize README”
- 创建后复制仓库的 SSH 地址，例如
git@gitHub.com:username/project.git
2. 初始化并提交本地项目
sh
cd 项目目录
git init # 初始化 git 仓库
git add . # 添加所有文件
git commit -m "first commit" # 提交代码cd 项目目录
git init # 初始化 git 仓库
git add . # 添加所有文件
git commit -m "first commit" # 提交代码3. 关联远程仓库并推送
sh
git remote add origin git@gitHub.com:username/project.git
git push -u origin mastergit remote add origin git@gitHub.com:username/project.git
git push -u origin master若提示 main 分支错误，请使用：
sh
git push -u origin maingit push -u origin main常见问题
| 问题 | 原因 | 解决方案 |
|---|---|---|
| Permission denied (publickey) | SSH Key 未配置或未添加到 gitHub | 重新生成并绑定 SSH Key |
| fatal: remote origin already exists | 已存在远程仓库关联 | 执行 git remote remove origin 后重新添加 |
| error: src refspec master does not match any | 当前分支不是 master | 使用 git push -u origin main |