Git配置SSH密钥与私钥的完整跨平台指南

SSH密钥认证是Git操作中最安全便捷的认证方式。本指南将详细介绍在Windows、macOS和Linux系统上生成、配置和使用SSH密钥的全流程。

一、检查现有SSH密钥

在生成新密钥前，先检查是否已有SSH密钥：

ls -al ~/.ssh

查看是否存在id_rsa、id_ed25519等文件。如果已有密钥且需要保留，请跳过生成步骤。

二、生成新的SSH密钥

1. 打开终端/命令行

Windows：使用Git Bash或PowerShell
macOS/Linux：使用系统终端

2. 生成密钥（推荐ED25519算法）

ssh-keygen -t ed25519 -C "your_email@example.com"

或使用传统RSA算法（兼容性更好）：

ssh-keygen -t rsa -b 4096 -C "your_email@example.com"

3. 设置保存路径和密码

按提示输入密钥保存路径（默认~/.ssh/id_ed25519）
设置密钥密码（可选但推荐）

三、将SSH密钥添加到ssh-agent

macOS/Linux

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Windows (Git Bash)

eval $(ssh-agent -s)
ssh-add ~/.ssh/id_ed25519

Windows (PowerShell)

Start-Service ssh-agent
ssh-add ~\.ssh\id_ed25519

四、将公钥添加到Git服务商

1. 复制公钥内容

# macOS/Linux
cat ~/.ssh/id_ed25519.pub | pbcopy

# Windows (Git Bash)
cat ~/.ssh/id_ed25519.pub | clip

# Linux (需要安装xclip)
sudo apt install xclip -y
cat ~/.ssh/id_ed25519.pub | xclip -selection clipboard

2. 添加到Git平台

GitHub：Settings → SSH and GPG keys → New SSH key
GitLab：Preferences → SSH Keys
Bitbucket：Personal settings → SSH keys

五、测试SSH连接

ssh -T git@github.com

成功时会显示认证用户名。

六、配置多账户SSH（可选）

如果需要为不同平台使用不同密钥：

创建config文件：

touch ~/.ssh/config
chmod 600 ~/.ssh/config

编辑config文件示例：

# GitHub账号
Host github.com
  HostName github.com
  User git
  IdentityFile ~/.ssh/id_ed25519_github
  IdentitiesOnly yes

# 公司GitLab账号
Host gitlab.company.com
  HostName gitlab.company.com
  User git
  IdentityFile ~/.ssh/id_rsa_work
  IdentitiesOnly yes