WebStorm版本控制可用的核心是三步：Git路径配对、项目根目录正确、VCS集成选Git；90%功能异常源于这三步未落实。
WebStorm 项目版本控制能用起来，核心就三件事：Git 路径配对、项目根目录建对、VCS 集成选对。 其他所有“功能灰掉”“右键没菜单”“提交不生效”的问题，90% 都卡在这三步里。
Git 可执行文件路径必须手动确认
WebStorm 不自带 Git，全靠调用你系统里的 git 命令。路径错、没装、装了但没进 PATH，它就直接“失明”。
- 打开
Settings/Preferences > Version Control > Git，看Path to Git executable字段是否填了真实路径（比如C:\Program Files\Git\bin\git.exe或/usr/local/bin/git） - 别信“自动检测”——重装 Git 或升级 WebStorm 后，这个字段常被清空或指向旧版本
- 点右边的
Test按钮，必须看到类似Git version 2.45.1的输出才算通过；报红或空白，就得手动找git.exe或终端里运行which git/where git确认位置 - macOS 用户尤其注意：Xcode 自带的老旧
git（v1.9.x）和 WebStorm 兼容性差，建议用brew install git覆盖安装
项目根目录必须是 Git 仓库的顶层
.git 目录不能建在 src 或 app 里，否则远程推送、分支切换、.gitignore 规则全失效。
- 新建项目时，在向导里直接勾选
Create Git repository—— 这是最稳的方式，.git一定落在项目根目录 - 已有项目要初始化：先确认当前打开的确实是项目根目录（即包含
package.json、pom.xml或README.md的那一层），再右键 →Git > Initialize Repository - 初始化后立刻看右下角状态栏：显示
main或master才算成功；如果还是灰色，大概率是误点了Enable Version Control Integration却选了None - 文件颜色是线索：
绿色表示已git add，蓝色表示修改未暂存，红色表示未跟踪（Unversioned）—— 别把node_modules/或.idea/误点成绿色提交
VCS 集成必须手动启用并绑定类型
即使 Git 路径正确、.git 也在根目录，WebStorm 仍可能“视而不见”，因为项目级 VCS 集成默认是关闭的。
- 顶部菜单 →
VCS > Enable Version Control Integration…，弹窗里下拉选择Git（不是留空，也不是选Subversion） - 如果之前用过 SVN 或 Mercurial，WebStorm 可能缓存了旧类型，此时需先
VCS > Import into Version Control > Create Git Repository强制覆盖 - 启用后，项目根目录图标会变（比如加 Git 小图标），右键菜单才出现
Git子项，Commit、Push等按钮才可点击 - 企业私有 Gitee？记得去
Settings > Version Control > Gitee改Server URL为内部地址，否则账户绑定后也推不上去
最容易被忽略的是：WebStorm 的 VCS 配置分两层——全局（Git 路径）和项目级（启用 + 类型绑定）。少一层，整个流程就断在半路。很多人反复重装插件、重启 IDE，其实只是漏点了那个下拉框里的 Git。
