如何在WebStorm中解决Git提交时的认证失败问题-webstorm-PHP中文网

WebStorm Git认证失败大概率是凭证缓存、令牌失效或SSH配置未走通；需先检查credential.helper配置、清理系统凭据（如Windows凭据管理器）、重置Git凭据助手，再在WebStorm中Push触发弹窗输入用户名和PAT，或启用Gitee插件走OAuth授权。

如何在webstorm中解决git提交时的认证失败问题

WebStorm 提交 Git 时提示 Authentication failed，大概率不是密码输错了，而是凭证缓存、令牌失效或 SSH 配置没走通——先别删重装，按下面几步定位更省时间。

为什么 WebStorm 总是认证失败，而命令行能推？

WebStorm 默认复用系统级 Git 凭证管理器（比如 Windows 的 Windows Credential Manager 或 macOS 的 Keychain），但它的行为和终端里手动运行 git push 不完全一致：

它可能读取了过期的 HTTPS 令牌，却没触发重新输入弹窗
它可能跳过了 SSH agent 的密钥加载（尤其在非 Bash 终端启动的 IDE 中）
Gitee 自 2021 年起已禁用密码登录，但旧缓存仍存着失效的密码字段，导致 Incorrect username or password (access token)

验证方法：在终端中执行 git push origin main，如果弹出输入框且成功，说明问题出在 WebStorm 的凭证链上，不是账号本身。

清除并重置 WebStorm 的 Git 凭据缓存

WebStorm 不直接管理凭据，但它依赖 Git 的 credential.helper 配置。错误配置会导致它反复尝试旧凭据而不提示更新。

先查当前配置：git config --global credential.helper，常见返回是 manager（Windows）、osxkeychain（macOS）或 store
如果是 manager，打开 Windows 控制面板 → 凭据管理器 → Windows 凭据 → 找到以 git:https://gitee.com 开头的条目 → 点击“编辑”或“删除”
如果是 store，删掉 ~/.git-credentials 文件（Linux/macOS）或 %USERPROFILE%\.git-credentials（Windows）
再执行一次 git config --global --unset credential.helper，让 Git 回退到最简模式（下次操作会强制弹窗）

做完后，在 WebStorm 里点 Push，应该会弹出登录窗口；此时输入 Gitee 用户名 + 个人访问令牌（不是密码），之后 WebStorm 就能记住新凭据了。

用 Gitee 插件替代手动配置凭证

WebStorm 官方 Gitee 插件（JetBrains 提供）绕过了 Git 原生凭证流程，改用 OAuth 授权，更稳定，也避免令牌权限遗漏。

github项目持续追踪

GitHub 项目更新追踪工具 - 自动检查多个 GitHub 项目的 Releases 和 CHANGELOG，生成更新摘要与影响分析报告。支持自动化定时任务。如何使用最简单的方式：直接用自然语言告诉我你可以说我会做「检查 GitHub 更新」检查最新版本「添加 vscode」追踪新项目「停止追踪 xxx」移除项目「暂停更新检查」暂停自动化「给我看 openclaw 报告」展示报告触发词：「追踪项目更新」「检查 GitHub 更新」「项目更新报告」「设置更新提醒」

下载

确保已安装插件：Settings → Plugins → 搜索 Gitee → 安装并重启 IDE
绑定账户：Settings → Version Control → Gitee → Add account → Log in via Gitee（会跳转浏览器完成授权）
授权后，WebStorm 会自动生成一个带 projects 和 pull_requests 权限的令牌，并持久化管理
注意：该方式仅对 Gitee 有效，不适用于 GitHub 或 GitLab；若项目远程地址是 HTTPS，插件会自动接管认证；若是 SSH 地址，则仍需本地 SSH 配置

这个路径下，你几乎不会遇到 Authentication failed，因为整个流程由插件控制，不经过系统凭据管理器。

SSH 方式下 WebStorm 找不到密钥怎么办？

即使 ssh -T git@gitee.com 在终端返回成功，WebStorm 仍可能报 Permission denied (publickey)——关键在于它是否用了同一个 SSH agent。

确认 SSH agent 正在运行：eval $(ssh-agent -s)（Linux/macOS）或确保 Git Bash 启动时已加载密钥
把私钥加进 agent：ssh-add ~/.ssh/id_rsa（路径要和 ~/.ssh/config 里写的匹配）

检查 ~/.ssh/config 是否有针对 Gitee 的 Host 配置，例如：

Host gitee.com
  HostName gitee.com
  User git
  IdentityFile ~/.ssh/id_rsa

在 WebStorm 中，Settings → Version Control → Git → SSH configuration → 选择 “Native SSH”（不要选 “Built-in”）

“Built-in” 是 WebStorm 自带的 JS 实现，不读取系统 ssh-agent 或 ~/.ssh/config，容易导致密钥不可见——这是最容易被忽略的开关。

真正卡住的地方往往不是“怎么配”，而是 WebStorm 暗地里走了哪条认证路径。看清它是走 HTTPS 凭据、Gitee 插件 OAuth 还是 SSH agent，比盲目重装 Git 或重设全局 config 有效得多。