path to git executable 报红或为空说明 webstorm 未找到系统 git，需先在终端执行 git --version 验证系统安装及 path 配置，再于 settings → version control → git 中手动指定正确路径（如 windows 的 c:\program files\git\cmd\git.exe），并点击 test 确认版本号。
Path to Git executable 报红或为空，说明 WebStorm 根本没找到 git
WebStorm 不自带 Git，它只负责调用你系统里装好的 git 命令。路径字段一红，所有 Git 功能（提交、推送、分支切换）全部失效。
先打开终端（Terminal），运行：git --version。如果报 command not found，问题不在 WebStorm，而在系统层面：
- Windows 用户：重装 Git 时务必勾选「Add Git to PATH」；若已装过，可手动把
C:\Program Files\Git\bin\git.exe或更推荐的C:\Program Files\Git\cmd\git.exe加入系统环境变量 PATH - macOS（Intel）：常用路径是
/usr/local/bin/git；M1/M2 芯片用户注意，Homebrew 默认装在/opt/homebrew/bin/git - Linux：通常为
/usr/bin/git，但某些发行版需手动安装git-core包
确认命令行能跑通后，再进 WebStorm 设置——File → Settings → Version Control → Git（macOS 是 WebStorm → Preferences），点右侧 … 手动选中那个 git.exe 或 git 文件，必须点 Test，看到绿色提示和版本号（如 Git version 2.45.1）才算真正连上。
VCS 菜单灰显、右下角不显示分支名，其实是项目没被识别为 Git 仓库
路径对了 ≠ Git 就启用了。WebStorm 只对“已被初始化为 Git 仓库”的项目才激活 VCS 功能。
检查项目根目录有没有 .git 文件夹（隐藏的）。没有的话，有两种常见情况：
- 新建项目时没勾选「Create Git repository」——这时手动执行
VCS → Enable Version Control Integration → Git，WebStorm 会自动在当前目录运行git init - 项目是从远程克隆来的，但没在 WebStorm 里正确打开根目录——确保你打开的是包含
.git的那一层文件夹，而不是它的子目录
如果项目已有 .git，但 WebStorm 还是不认，尝试关闭项目，重新用 Open → 选中项目根目录 打开，别用“Recent Projects”直接进。
SSH 推送失败：Failed with error: Could not read from remote repository
这错误不是 WebStorm 配置问题，而是 Git 认证环节断了。最常见原因是 SSH 密钥没配好，或 WebStorm 没走 SSH 协议。
先确认你远程地址是 SSH 格式（git@github.com:user/repo.git），不是 HTTPS（https://github.com/user/repo.git）。如果是 HTTPS 地址，WebStorm 默认走账号密码认证，但 GitHub 已禁用密码登录，必须换 SSH 或用 Personal Access Token（PAT）。
推荐用 SSH：
- 终端运行
ssh-keygen -t ed25519 -C "your_email@example.com"生成密钥（比 rsa 更安全） - 把公钥内容（
~/.ssh/id_ed25519.pub）粘贴到 GitHub → Settings → SSH and GPG keys - 在 WebStorm 的
Settings → Version Control → Git中，把SSH executable设为Native（别用内置）
如果坚持用 HTTPS，就得去 GitHub 创建 PAT（选 repo 权限），然后在 WebStorm 的 Settings → Version Control → GitHub 里填进去，而不是输密码。
Test 按钮通过了，但 push/pull 仍失败，可能卡在代理或权限上
Test 只验证 git --version 能跑，不代表网络、权限、远程地址都 OK。常见卡点：
- 公司内网或校园网开了代理：WebStorm 默认不继承系统代理，需在
Help → Edit Custom VM Options里加-Dhttp.proxyHost=xxx等参数，或改用 SSH（绕过 HTTP 代理） - 远程仓库地址写错：比如把
git@gitlab.com:user/proj.git写成git@gitlab.com:user/proj（少 .git 后缀） - 本地分支没关联上游：第一次 push 时没加
-u origin main，WebStorm 里对应操作是右键分支 →Git → Branches → Track Remote Branch
真遇到疑难问题，别只盯着 WebStorm 界面——打开底部 Terminal 标签页，手动敲 git status、git remote -v、git config --get-regexp ssh，这些原始命令的输出比 IDE 提示更准、更直白。
