Git 推送报错“密码认证不支持”？切换到 SSH 密钥方案

问题背景

最近在新系统上进行 Git 操作时，可能会遇到 remote: Invalid username or token. Password authentication is not supported for Git operations 的错误。这是因为 GitHub 已不再支持使用账号密码进行 HTTPS 推送，建议改用 SSH 密钥来维持长期的安全连接。

生成 SSH 密钥

在终端执行以下命令生成密钥对：

ssh-keygen -t ed25519 -C "[email protected]"

参数 -t 指定密钥算法，这里选用 ed25519，相比传统 RSA 更安全且性能更优。按提示一路回车即可，私钥会保存在 ~/.ssh/id_ed25519。

将公钥添加到 GitHub

查看生成的公钥内容：

cat ~/.ssh/id_ed25519.pub

复制输出的全部内容，登录 GitHub 进入 Settings -> SSH and GPG keys -> New SSH key。粘贴到文本框中，自定义一个标题，密钥类型保持默认的 Authentication key，点击 'Add SSH key' 保存。

修改远程仓库地址

回到本地仓库，将远程地址从 HTTPS 改为 SSH 格式：

git remote set-url origin [email protected]:username/reponame.git

请将 username 和 reponame 替换为你自己的用户名和仓库名称。这一步是为了让 Git 知道下次推送该走哪个通道。

测试连接与推送

先测试 SSH 是否配置正确：

ssh -T [email protected]

如果看到类似 Hi username! You've successfully authenticated... 的提示，说明配置无误。此时再进行首次推送：

git push -u origin master

参数 -u 用于建立本地分支与远程分支的关联，以后只需写 git push 或 git pull 即可，无需再输入冗长的命令或凭证。