Mac 配置 GitHub SSH 密钥完整指南
本指南将带你完成在 macOS 上配置 SSH 密钥的全过程,实现通过 SSH 方式安全、便捷地克隆和管理 GitHub 仓库。
为什么推荐 SSH?
SSH(Secure Shell)是一种加密的网络协议。相比 HTTPS,使用 SSH 有以下优势:
- 更安全:基于密钥对加密,无需每次输入密码。
- 更方便:配置一次后,
git push、git pull等操作自动验证身份。 - 更高效:省去了重复的身份验证步骤。
简单来说,HTTPS 像刷门禁卡(每次都要验证),而 SSH 像指纹解锁(配好之后自动通行)。
开始前准备
确保你的环境满足以下条件:
- macOS 系统。
- 已安装 Git(终端输入
git --version检查)。 - 拥有 GitHub 账号。
打开终端
你可以通过 Spotlight 搜索'终端'或从 Finder → 应用程序 → 实用工具中找到它。打开后,你会看到类似这样的提示符:
yourname@MacBook-Pro ~ %
接下来的所有命令都将在该窗口中执行。
检查本地密钥状态
为了避免重复创建,先确认是否已有 SSH 密钥。在终端输入:
ls -al ~/.ssh
- 情况 1:已有密钥
如果看到
id_ed25519或id_rsa相关文件,说明已存在,可直接跳到后续添加步骤。 - 情况 2:没有密钥
如果提示
No such file or directory,则需要生成新密钥。
生成新的 SSH 密钥
SSH 密钥包含私钥(保存在本地,绝对保密)和公钥(上传到 GitHub)。
1. 生成密钥对
在终端执行以下命令,记得替换为你自己的邮箱:
ssh-keygen -t ed25519 -C "[email protected]"
-t ed25519:使用更安全的 Ed25519 算法。-C:添加注释以便识别。
如果提示不支持该算法,可改用
ssh-keygen -t rsa -b 4096。
2. 保存路径
系统会询问保存位置,直接按回车使用默认路径 /Users/你的用户名/.ssh/id_ed25519 即可。
3. 设置密码(可选)
系统会要求设置 passphrase:
- 建议设置:即使私钥文件泄露,他人也无法直接使用。
- 不设置:使用时完全免密,但安全性较低。
4. 生成成功
看到类似 Your identification has been saved... 的提示即表示成功。此时你拥有了私钥和公钥文件。

