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

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模式。这两步没搞定，后面做再多操作，可能都是在原地打转。