WebStorm 配置 GitHub 必须使用 Personal Access Token（PAT）或 SSH，禁用密码认证；Token 需勾选 repo 等权限并粘贴至登录界面，SSH 则需生成密钥、添加公钥、设 Git 远程地址为 git@github.com 格式。
WebStorm 配置 GitHub 账号，核心不是输密码，而是用 Personal Access Token（PAT）登录 —— 密码方式在 2021 年 8 月后已被 GitHub 官方弃用，直接填用户名+密码会始终提示 Authentication failed。
为什么填密码总是失败？
GitHub 已全面停用账户密码对 Git 操作的认证。即使 WebStorm 界面仍显示 Password 选项，实际底层调用的是 OAuth 或 Token 认证。你看到的“Test”按钮成功，只是校验了账号格式，不代表后续 push/pull 能通。
- 错误现象：
remote: Support for password authentication was removed on August 13, 2021 - 真实原因：WebStorm 的
Auth Type: Password是历史遗留 UI，不可用 - 必须改用
Auth Type: Token，且 Token 必须含repo范围权限
如何生成并配置有效 Token
Token 是唯一可靠方式，且需手动勾选关键 scope：
- 访问 https://www.php.cn/link/9c450eb90c31bc12f1691f235da5a0cc
- 填写
Note（如webstorm-2026），便于后期识别和删除 - 勾选至少以下三项：
repo（读写私有/公开仓库）、gist（可选）、read:org（若用组织仓库） - 点击
Generate token，页面跳转后立即复制整段 token（只显示一次！） - 回到 WebStorm：
Settings → Version Control → GitHub → Add Account → Login with Token，粘贴 token，点Add Account
SSH 配置不是必须，但能绕过 Token 过期问题
Token 有生命周期（可设为永不过期，但 GitHub 建议定期轮换），而 SSH key 一旦配好，只要私钥不丢、公钥没被删，就长期有效：
- 用
ssh-keygen -t ed25519 -C "your_email@example.com"生成现代密钥（比 rsa 更安全） - 公钥内容（
id_ed25519.pub文件全文）粘贴到 GitHub →Settings → SSH and GPG keys → New SSH key - WebStorm 中无需额外设置 SSH —— 只要本地
git命令能走 SSH（git@github.com:user/repo.git），IDE 就自动复用 - 验证是否生效：
ssh -T git@github.com应返回Hi username! You've successfully authenticated...
WebStorm 内部 Git 路径和 SSH 执行器要匹配
很多人卡在“Token 配好了却还是推不上去”，其实是 Git 和 SSH 层没对齐：
-
Settings → Version Control → Git：确认Path to Git executable指向你安装的git.exe（Windows）或/usr/bin/git（macOS） -
Settings → Version Control → Git → SSH Configurations：把SSH executable设为Native（不是内置的IDE）—— 否则 WebStorm 会忽略系统级 SSH 配置和 known_hosts - 克隆时务必用 SSH 地址（
git@github.com:user/repo.git），而非 HTTPS 地址（https://github.com/user/repo.git），后者仍会尝试走 Token
最易被忽略的一点：WebStorm 的 VCS → Git → Remotes 里显示的远程地址，可能还是旧的 HTTPS 地址。哪怕你 Token 配得再准，只要 remote URL 没切到 SSH，它就永远走不通。右键项目 → Git → Repository → Remotes，双击编辑，替换成 git@github.com:xxx/yyy.git —— 这步漏掉，前面全白配。
