macOS 配置 Git 平台 SSH 连接
(适用于 Gitee、GitHub、GitLab 等所有 Git 代码托管平台)
一、核心目标
通过 SSH 密钥认证,实现 macOS 终端与任意 Git 平台(Gitee、GitHub、GitLab 等)的无密码连接,后续克隆、拉取、推送仓库时无需重复输入账号密码。
二、前置准备
- 已安装 Git(macOS 自带 Git,若未安装自行安装即可);
- 已注册目标 Git 平台(如 Gitee、GitHub)账号,并绑定常用邮箱。
三、操作步骤
1. 检查本地是否已有 SSH 密钥
操作命令
ls -la ~/.ssh
结果说明
- 若输出中包含
id_ed25519(私钥)和id_ed25519.pub(公钥),说明已有现代 ED25519 算法密钥,直接跳至步骤 3; - 若包含
id_rsa(私钥)和id_rsa.pub(公钥),说明已有传统 RSA 算法密钥,也可直接使用(跳至步骤 3); - 若未找到上述文件,需执行步骤 2 生成新密钥。
2. 生成 SSH 密钥(无密钥时执行)
推荐使用 ED25519 算法(现代标准,更安全高效),也支持传统 RSA 算法(兼容旧系统)。
方式 1:生成 ED25519 密钥(推荐)
# 替换为你的 Git 平台绑定邮箱(如 [email protected])
ssh-keygen -t ed25519 -C "你的邮箱地址"
方式 2:生成 RSA 密钥(兼容旧系统)
# 替换为你的 Git 平台绑定邮箱
ssh-keygen -t rsa -b 4096 -C "你的邮箱地址"
# -b 4096 表示密钥长度(越长越安全,推荐 4096 位)
交互提示处理
- 提示
Enter file in which to save the key (/Users/你的用户名/.ssh/id_ed25519):→ 直接回车(使用默认路径); - 提示
Enter passphrase (empty for no passphrase):→ 直接回车(无需密钥密码,若需额外安全验证可设置密码); - 提示
Enter same passphrase again:→ 直接回车(与上一步保持一致)。
生成成功标志
终端显示密钥保存路径(/Users/你的用户名/.ssh/)和指纹信息,此时 .ssh 目录下新增:
- 私钥(如
id_ed25519或id_rsa,需绝对保密,不可泄露); - 公钥(如
id_ed25519.pub或id_rsa.pub,需上传至 Git 平台)。
3. 获取本地公钥内容
根据生成的密钥类型,执行对应命令复制公钥:


