Linux安装Git与SSH配置详解

本文手把手教你如何在Linux系统中高效安装Git并完成SSH密钥配置，直击新手最常卡壳的三大痛点：Git版本过低导致GitHub认证失败、ssh-keygen参数选错或密钥路径配置错误、以及GitHub公钥添加不规范；通过几条简洁命令即可完成Ed25519密钥生成、SSH Agent加载、~/.ssh/config精准配置和公钥验证，确保稳定连接GitHub——原来配SSH根本不用折腾，关键只在细节到位。

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----- 结束，中间不能断、不能缩进、不能带注释行。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~