Linux装Git和配SSH Key连GitHub只需几条命令，关键在选对ssh-keygen参数、正确写~/.ssh/config路径、确保GitHub添加公钥无误。
Linux 上装 Git 和配 SSH Key 连 GitHub，根本不用折腾——系统自带包管理器几条命令就能搞定，但很多人卡在 ssh-keygen 参数选错、~/.ssh/config 写错路径、或 GitHub 没正确添加公钥这三步上。
确认 Git 是否已安装并升级到可用版本
多数现代 Linux 发行版（Ubuntu 22.04+、Fedora 36+、Debian 12+）预装了 Git，但版本可能偏低（比如 2.30），而 GitHub 对某些新认证机制（如 token 替代密码）有最低版本要求。别直接 git --version 看完就跳过，得验证是否支持 HTTPS 凭据缓存和 SSH Agent。
- 运行
git --version；若低于2.34，建议升级：Ubuntu/Debian 用sudo apt update && sudo apt install git，Fedora/CentOS 用sudo dnf install git - 检查 SSH 支持：
git ls-remote -h git@github.com:username/repo.git（随便一个公开 repo），如果报Permission denied (publickey)说明 Git 能走 SSH，只是密钥没配好；如果报fatal: unable to access ...: Could not resolve host才是网络或 Git 本身问题
生成并加载 SSH Key 的关键参数和路径
ssh-keygen 默认生成 id_rsa，但 GitHub 现在推荐 Ed25519（更快更安全），且必须指定 -C 参数绑定邮箱（否则 GitHub 后台无法识别是谁提交的 key）。更重要的是，私钥文件名不能随意改，否则 ssh-add 找不到，或者 ~/.ssh/config 里得手动写死路径。
- 生成推荐密钥：
ssh-keygen -t ed25519 -C "your_email@example.com"（一路回车，默认保存为~/.ssh/id_ed25519） - 启动 agent 并加载：
eval "$(ssh-agent -s)"，然后ssh-add ~/.ssh/id_ed25519；如果提示Could not open a connection to your authentication agent，说明 agent 没起来，别跳过eval这步 - 别用
ssh-keygen -t rsa -b 4096——不是不行，但 GitHub 文档已不优先展示，且老 RSA 密钥在某些 CI 环境里会触发额外警告
配置 GitHub SSH 连接不靠默认 host 名
直接 git clone git@github.com:user/repo.git 能通，不代表你本地配置就稳。一旦你同时用多个 GitHub 账号（比如工作和个人），或者想把所有 GitHub 流量强制走特定端口/代理，就必须靠 ~/.ssh/config 控制行为。这里最容易出错的是 Host 别名重复、Hostname 写成 IP、或 IdentityFile 路径漏掉 ~。
- 编辑
~/.ssh/config，加入：Host github.com HostName github.com User git IdentityFile ~/.ssh/id_ed25519
- 切记：Host 行写的是你在 git URL 里用的名字（比如
git@github.com:...中的github.com），不是你想自定义的别名；如果想用git@gh-personal:...，那 Host 就得写gh-personal，再配对应的 HostName 和 IdentityFile - 测试是否生效：
ssh -T git@github.com；成功返回Hi username! You've successfully authenticated...才算通，光不报错不等于连上了
真正麻烦的不是生成密钥，而是 ssh-add 加载后没进 shell session 生命周期，或者 GitHub Settings → SSH and GPG keys 页面粘贴时多空格、少换行——公钥内容必须从 -----BEGIN OPENSSH PRIVATE KEY----- 开始，到 -----END OPENSSH PRIVATE KEY----- 结束，中间不能断、不能缩进、不能带注释行。
