解决 VS Code 中 Git 推送报错：ECONNREFUSED vscode-git.sock 与鉴权失败

我们在日常开发中，经常会在 VS Code 的集成终端里直接执行 Git 命令。但有时候，当你满心欢喜地敲下 git push 时，屏幕上可能会突然弹出一大串包含 ECONNREFUSED 和 .sock 文件的红字，紧接着告诉你"鉴权失败"。

今天我们就来彻底盘点一下这个常见报错的原因和多种解决方法。

🎯 问题现象

当你执行 git push origin master（或其他分支）时，终端出现如下报错日志：

bash 复制代码

Missing or invalid credentials.
Error: connect ECONNREFUSED /run/user/1000/vscode-git-90ea597360.sock
    at PipeConnectWrap.afterConnect [as oncomplete] (node:net:1637:16) {
  errno: -111,
  code: 'ECONNREFUSED',
  syscall: 'connect',
  address: '/run/user/1000/vscode-git-90ea597360.sock'
}
remote: HTTP Basic: Access denied
fatal: 'http://192.168.1.18/pengguangjie/kylin-v10-digitalme-docker.git/' 鉴权失败

🔍 原因分析

这个报错看似吓人，其实是由两个关联问题叠加造成的：

VS Code 的密码拦截机制失效 (ECONNREFUSED ... .sock)

在 VS Code 的集成终端中执行 Git 命令时，VS Code 会通过设置环境变量 GIT_ASKPASS 来接管 Git 的密码输入逻辑。它的本意是好的：想在编辑器顶部弹出一个漂亮的 UI 输入框让你输密码。

但是，这个拦截机制依赖底层的 socket 文件（也就是报错里的 .sock 文件）进行通信。如果你的终端闲置太久、断网重连过，或者 VS Code 刚刚发生过重载，这个 socket 连接就会失效。VS Code 无法正常弹出输入框，导致报错。
Git 鉴权失败 (HTTP Basic: Access denied)

因为 VS Code 接管密码失败，Git 无法获取到正确的临时凭证；或者系统底层缓存了错误的旧密码，最终导致向 Git 服务器发送了错误的鉴权请求，从而被服务器拒绝（Access denied）。

🛠️ 解决方案

根据你的具体需求，这里提供 4 种解决方法，从"临时救急"到"一劳永逸"。

方案一：绕过 VS Code，强制在终端输入密码（最快救急）

既然 VS Code 的弹窗机制坏了，我们可以临时清空 GIT_ASKPASS 环境变量，强迫 Git 回退到最原始的模式------直接在终端里提示你输入账号和密码。

只需在命令前加上环境变量的覆盖：

bash 复制代码

GIT_ASKPASS="" git push origin master

执行后，终端会像往常一样提示 Username for ...: 和 Password:，输入正确的账号密码即可推送成功。

方案二：重启 VS Code 终端（最符合直觉）

如果你依然喜欢使用 VS Code 的弹窗来输入密码，最简单的方法就是重新生成那个失效的 .sock 文件。

点击集成终端右上角的 垃圾桶图标 🗑️，直接关掉当前终端进程。
在 VS Code 顶部菜单栏选择 终端 (Terminal) -> 新建终端 (New Terminal)。
再次执行 git push origin master。

此时，全新的终端环境会生成新的 socket 链接，VS Code 的密码弹窗就会乖乖出现了。

方案三：清理并重置 Git 本地密码缓存（如果是密码存错了）

有时候 socket 没问题，但因为你之前输错过一次密码并且被系统记住了，导致每次都会直接抛出"鉴权失败"。

清除当前缓存在内存中的凭证：
bash 复制代码
```
git credential-cache exit
```
为了避免以后多次输入用户名，建议在 remote 链接里把用户名写死：
bash 复制代码
```
git remote set-url origin http://<你的用户名>@192.168.1.18/your-repo.git
```
再次使用 GIT_ASKPASS="" git push origin master 推送，重新输入一次正确的密码。

方案四：改用 SSH 密钥认证（一劳永逸，强烈推荐 ⭐）

HTTP/HTTPS 方式克隆的代码总是会面临频繁输入密码和凭证过期的问题。作为一名成熟的开发者，配置 SSH 密钥才是终极解决之道，配置完成后，上述所有烦恼都将烟消云散。

第 1 步：生成本地 SSH 密钥

bash 复制代码

ssh-keygen -t rsa -b 4096 -C "你的邮箱@example.com"

(一路回车，不需要设置额外密码)

第 2 步：将公钥添加到 Git 服务器

查看并复制你的公钥内容：

bash 复制代码

cat ~/.ssh/id_rsa.pub

登录你的 GitLab/Gitea/GitHub 平台，在"个人设置 -> SSH Keys"中，将复制的内容粘贴进去并保存。

第 3 步：修改本地仓库的远程地址为 SSH 格式

将原来的 http:// 链接替换为 git@ 开头的 SSH 链接：

bash 复制代码

git remote set-url origin git@192.168.1.18:pengguangjie/kylin-v10-digitalme-docker.git

第 4 步：测试推送

bash 复制代码

git push origin master

此时你无需输入任何密码，代码瞬间推送成功！不仅速度更快，而且彻底摆脱了 VS Code 环境变量带来的诡异报错。

总结：

遇到 .sock ECONNREFUSED 报错不要慌，它只是 VS Code 的一个小脾气。你可以用 GIT_ASKPASS="" 绕过它，也可以重启终端安抚它，但长远来看，拥抱 SSH 才是最省心的选择。希望这篇文章能帮你节省宝贵的 Debug 时间！