VSCode解决Git权限报错:免密推送代码至GitHub配置教程

在VSCode里遇到Git推送报错Permission denied (publickey),先别急着折腾编辑器设置。问题的根源往往不在VSCode本身,而是你系统的Git环境在终端里就没走通——VSCode只是忠实地复用了这个环境而已。
检查当前 remote 地址是不是 SSH 格式
首先得明确一点:VSCode的Git面板可不会主动帮你把HTTPS地址转换成SSH。如果你最初克隆仓库用的是https://github.com/user/repo.git这个链接,那么后续所有的推送和拉取操作,都会默认走HTTPS协议。这时候,就算你生成了SSH密钥,也完全派不上用场。
怎么确认和修正呢?其实很简单:
- 进入你的项目根目录,打开VSCode的集成终端(快捷键
Ctrl + `),运行命令:git remote get-url origin - 如果终端输出的地址是以
https://...开头的,那就必须手动把它改过来:git remote set-url origin git@github.com:user/repo.git - 改完之后,别忘了再运行一次
git remote get-url origin确认一下,确保地址已经变成了git@...的格式。
验证 SSH 密钥是否真能被 git 调用
接下来是关键一步:你的SSH密钥真的被正确加载了吗?VSCode启动时会继承系统Shell(比如PowerShell或Git Bash)的环境变量,但它可不会自动帮你启动ssh-agent或者加载私钥。很多“配置了密钥却依然失败”的情况,问题就出在这里。
验证方法很直接:
- 在VSCode的终端里执行:
ssh -T git@github.com - 如果返回
Welcome to GitHub, xxx!这样的欢迎信息,恭喜你,密钥是可用的。如果依然看到Permission denied (publickey),那就说明袋里没启动,或者密钥权限有问题。 - 这时候,你需要执行一次性的补救操作:先运行
eval "$(ssh-agent -s)"来启动袋里,然后通过ssh-add ~/.ssh/id_ed25519加载你的私钥(注意,这里的路径需要替换成你实际生成密钥的位置)。 - 对于Windows用户有个小提示:
~/.ssh/id_ed25519这个路径,通常对应的是C:\Users\你的用户名\.ssh\id_ed25519。
确保私钥文件权限严格(尤其 Windows WSL 或 Git Bash)
OpenSSH对私钥文件的权限非常敏感,这是出于安全考虑。如果你的私钥文件被设置成了“所有人可读”,那么ssh-add命令会默默地拒绝加载它,从而导致后续所有的SSH操作失败。
如何修正权限?分情况处理:
- 如果你在使用Git Bash,运行这条命令即可:
chmod 600 ~/.ssh/id_ed25519 - 如果是在PowerShell环境下,由于不支持
chmod,可以改用这条命令来重置权限:icacls ~/.ssh/id_ed25519 /reset /inheritance:r /grant:r "$env:USERNAME:(R)" - 记住,只需要调整私钥(如
id_ed25519)的权限,公钥文件(id_ed25519.pub)本来就是公开的,不需要动。
VSCode 自身配置只需确认 git.path 正确
最后,关于VSCode本身的配置,其实非常简单。它并不需要你单独去“登录GitHub”或者填写账号密码。它的所有Git操作,都完全依赖于系统安装的Git以及你在终端里配置好的SSH环境。唯一需要你核对的,就是VSCode是否找到了正确的Git可执行文件。
按下面步骤检查一下:
- 打开VSCode设置(
Ctrl + ,),搜索git.path。 - 点击“在settings.json中编辑”,确认它的值指向了正确的
git.exe路径,例如:"git.path": "C:\\Program Files\\Git\\bin\\git.exe" - 这里有个常见的坑:路径不能指向
cmd\git.exe(那只是一个命令行封装器),必须指向bin\git.exe,否则SSH认证无法生效。 - 修改完成后,记得重启一下VSCode的终端(关掉当前终端窗口,再用
Ctrl + `新建一个)。
说到底,最容易被忽略的两个关键点,其实就是ssh-agent没有持续运行,以及仓库的远程地址还停留在HTTPS模式。这两步没搞定,后面做再多操作,可能都是在原地打转。