Mac环境中，使用git的SSH协议上传大文件到gitHub仓库

HTTPS 协议对大文件传输的兼容性较差，SSH 协议更稳定且无缓冲区限制，能够解决大文件无法上传到git仓库的问题。

查看SSH密钥

确认本地是否已生成 SSH 密钥：

# 列出 .ssh 目录下的密钥文件
ls -la ~/.ssh

若看到 id_rsa 和 id_rsa.pub（或 id_ed25519 和 id_ed25519.pub），说明已有密钥。
若没有，则需要生成新的 SSH 密钥。

生成 SSH 密钥

ssh-keygen -t ed25519 -C "github邮箱地址" 

执行后会提示 “Enter a file in which to save the key”，直接按回车（使用默认路径）。

接着会提示设置密码（passphrase），可直接回车跳过（无需密码），或设置密码增强安全性。

确保 SSH 密钥已添加到 ssh-agent

生成密钥后，需要将其添加到本地的 ssh-agent 中（管理 SSH 密钥的工具）：

# 启动 ssh-agent
eval "$(ssh-agent -s)"

# 添加私钥
ssh-add ~/.ssh/id_ed25519

若提示 “Could not open a connection to your authentication agent”，先执行 ssh-agent bash 再重试 ssh-add。

查看密钥

cat ~/.ssh/id_ed25519.pub

输出类似：ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIK... 你的邮箱，复制整行内容（包括邮箱）。

设置密钥

打开 GitHub 仓库 → Settings → Deploy keys → Add deploy key，粘贴公钥并保存。

验证 SSH 连接是否成功

执行以下命令测试是否能通过 SSH 连接 GitHub：

ssh -T git@github.com

首次连接会提示 “Are you sure you want to continue connecting”，输入 yes 回车。
若成功，会显示：

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

若仍失败，检查公钥是否复制完整、是否添加到正确的 GitHub 账户（尤其是多人共用设备时）。

设置SSH地址并推送

# 查看当前远程地址
git remote -v
# 移除 HTTPS 地址
git remote remove origin

# 添加 SSH 仓库地址（格式：git@github.com:用户名/仓库名.git）
git remote add origin git@github.com:你的用户名/你的仓库名.git

# 验证远程地址是否正确(输出应显示 origin 对应的是 git@github.com 开头的地址)
git remote -v

接下来就可以进行推送或者拉取了。