前言
在使用 Git 进行版本控制时,SSH 是一种安全、高效的认证方式。通过配置 SSH 密钥对(公钥和私钥),我们可以免去每次操作远程仓库时输入用户名和密码的麻烦。
本文将详细介绍如何生成 SSH 密钥对,并将其配置到 Git 和 GitHub(或其他平台)中。内容涵盖 macOS、Windows 和 Linux 三大主流操作系统平台,帮助你完成完整的 SSH 密钥配置流程。
一、检查是否已有 SSH 密钥
在开始之前,先检查本地是否已经存在 SSH 密钥对:
ls -al ~/.ssh
如果你看到如下文件,则说明已经有密钥对了:
id_rsa(私钥)id_rsa.pub(公钥)
你可以选择继续使用现有密钥,或跳过此步骤并生成新的密钥对。
二、生成新的 SSH 密钥对
无论使用哪种操作系统,我们都可以使用以下命令生成新的 SSH 密钥对:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
macOS
- 打开 终端(Terminal)。
- 输入上述命令生成密钥对。
- 按照提示选择保存路径(默认为
~/.ssh/id_rsa)。 - 设置一个可选的密码来保护你的私钥。
添加到钥匙串(推荐)
为了更方便地管理你的 SSH 私钥,在 macOS 上你可以运行以下命令将私钥添加到钥匙串中:
ssh-add --apple-use-keychain ~/.ssh/id_rsa
这样可以避免每次使用时都要输入密码。
Windows
建议使用 Git Bash 或 PowerShell 来执行命令。
- 打开 Git Bash 或 PowerShell。
- 输入以下命令生成密钥对:
ssh-keygen -t rsa -b 4096 -C "[email protected]"
- 按照提示选择保存路径,默认为
C:\Users\<YourUsername>\.ssh\id_rsa。 - 可选:设置密码以增强安全性。
使用 SSH Agent
为了让 Windows 记住你的 SSH 密钥,你需要启动 SSH Agent 并添加你的私钥:
# 启动 SSH Agent
eval "$(ssh-agent -s)"
# 添加私钥
ssh-add ~/.ssh/id_rsa
💡 如果你使用的是 Windows 10/11,也可以启用 OpenSSH 客户端:
控制面板 > 程序 > 启用或关闭 Windows 功能 > OpenSSH 客户端


