mac 上配置 github ssh 密钥需三步：生成 ed25519 密钥对、启动 ssh-agent 并添加私钥、将公钥添加至 github 账户；全程终端操作，注意路径、算法与权限，最后改用 ssh 地址同步仓库。

mac 上生成和管理 github ssh 密钥，核心是三步：生成密钥对、启动并配置 ssh-agent、把公钥加到 github 账户。整个过程不需要第三方工具，终端命令就能完成，关键是路径、算法和权限别出错。

检查是否已有密钥

先确认有没有旧密钥干扰新配置：

• 打开终端，执行 ls -al ~/.ssh
• 如果看到 id_rsa 或 id_ed25519 等文件，说明已有密钥；若只是想换新密钥，建议先备份再删（比如 mv ~/.ssh/id_rsa ~/.ssh/id_rsa_backup）
• 如果提示 No such file or directory，说明 .ssh 目录不存在，可直接进入下一步

生成推荐的 SSH 密钥

GitHub 官方推荐使用 ed25519 算法，更安全且速度快。macOS 10.12 及以上都支持：

• 运行命令：ssh-keygen -t ed25519 -C "your_email@example.com"（把邮箱换成你 GitHub 绑定的邮箱）
• 按回车接受默认保存路径 ~/.ssh/id_ed25519
• 密码短语（passphrase）可留空（直接回车），适合日常开发；如需更高安全性，可设一个强密码
• 成功后会显示密钥指纹和随机画，同时生成两个文件：id_ed25519（私钥）和 id_ed25519.pub（公钥）

启用 ssh-agent 并加载私钥

ssh-agent 能帮你记住密码短语，避免每次 Git 操作都输密码：

Git Repo Reader

辅助阅读和快速理解 GitHub/Git 项目结构与核心价值的结构化方法论。 当用户请求"分析这个 GitHub 项目"、"帮我读一下这个 repo"、"了解这个项目是做什么的"、 "怎么用这个项目"、"怎么跑这个项目"、"这个项目用了哪些技术"，或任何涉及 GitHub/Git 仓库阅读、理解、技术评估、快速上...

下载

• 启动 agent：eval "$(ssh-agent -s)"
• 把私钥加入 agent：ssh-add ~/.ssh/id_ed25519
• 如果设置了密码短语，此时会提示输入一次；没设则直接成功
• 验证是否加载成功：ssh-add -l 应该列出你的密钥指纹

把公钥添加到 GitHub

这一步让 GitHub 认得你的电脑：

• 复制公钥内容：cat ~/.ssh/id_ed25519.pub | pbcopy（pbcopy 是 macOS 命令，自动复制到剪贴板）
• 登录 GitHub → 点右上角头像 → Settings → SSH and GPG keys → New SSH key
• Title 填个易识别的名字（比如 “MacBook Pro – work”）
• Paste your SSH key 的内容，点 Add SSH key
• 最后测试连接：ssh -T git@github.com，看到 Hi username! You've successfully authenticated... 就说明通了

配完之后，本地仓库的 remote 地址记得改成 SSH 格式：git@github.com:username/repo.git，不是 HTTPS 链接。这样 push/pull 就走 SSH 通道了。