git没装或路径不对会导致webstorm git功能瘫痪；需在settings→version control→git中手动配置正确路径并test验证，新建项目务必勾选“create git repository”，已有项目须确保打开根目录并启用git集成。
Git没装或路径不对，WebStorm的Git功能直接瘫痪
WebStorm本身不带Git，它只是调用你系统里已安装的git命令。如果git没装，或者装了但WebStorm找不到可执行文件，所有Git菜单（VCS → Git、右键菜单里的Git选项）都会是灰色、点不动的。
验证方式很简单：打开File → Settings → Version Control → Git（macOS是Preferences），看Path to Git executable字段：
- 显示路径且右侧“Test”按钮提示绿色“Git version X.X.X” → OK
- 为空、红字报错、或指向一个已卸载Git的旧路径 → 必须手动修正
常见路径参考：
- Windows：
C:\Program Files\Git\bin\git.exe（注意不是cmd\git.exe） - macOS（Homebrew）：
/opt/homebrew/bin/git或/usr/local/bin/git - Linux：
/usr/bin/git
别信“自动检测”——重装Git、升级WebStorm后，这个字段常被清空。每次环境变动后都建议点一下Test确认。
新建项目时漏勾“Create Git repository”，.git位置就错了
很多人手抖跳过这一步，后续再右键“Git → Initialize Repository”，结果.git目录被建在src/或dist/里，而不是项目根目录。后果很直接：无法正确关联远程仓库、git remote add失败、push报错refusing to update checked out branch。
正确做法：
- 新建项目向导中，**务必勾选“Create Git repository”** —— WebStorm会把
.git放在你指定的项目根目录下（即含package.json或webpack.config.js的那层） - 对已有项目？先确认当前打开的是否为**真正的项目根目录**（不是子文件夹）。如果不是，关掉项目，重新以该目录为根打开，再操作
初始化完成后，看IDE右下角状态栏：出现main或master字样，说明Git已启用；如果还是灰色，检查是否误点了Enable Version Control Integration却选了None。
文件颜色不是装饰，是Git状态的实时翻译
WebStorm用颜色直白告诉你每个文件处于什么Git状态，但看不懂就容易误操作：
-
绿色：文件已
git add进暂存区，下次commit会带上它 -
蓝色：文件已被Git跟踪，但内容有修改、尚未
add，也不会被提交 -
红色：文件全新、Git完全不知道它存在（Unversioned），比如刚建的
config.local.js—— 不点“Add to VCS”就commit，它不会出现 - 灰色/黑色：和HEAD一致，干净无改动
特别注意：.idea/workspace.xml、node_modules/这类文件即使变绿也不该提交。解决方法有两个：
- 在
Settings → Version Control → Ignored Files里加忽略规则 - 更推荐：在项目根目录手动加
.gitignore文件，写入node_modules/、.idea/等
Gitee推送失败，大概率卡在插件或账户绑定环节
WebStorm 2024 默认不带Gitee支持，必须装官方插件。很多人只装了插件但没重启IDE，或绑定了GitHub账号却以为Gitee也通了。
关键步骤：
- 装插件：
Settings → Plugins → Marketplace搜Gitee，装JetBrains官方版，**必须重启IDE** - 绑定账户：
Settings → Version Control → Gitee → Add account → Log in via Gitee，会跳转浏览器走OAuth授权 - 推送前确认远程地址：
VCS → Git → Remotes里看URL是不是https://gitee.com/xxx/yyy.git，不是GitHub或GitLab的
常见报错Authentication failed for 'https://gitee.com/...'，90%是因为没走OAuth绑定，而是试图用密码登录——Gitee已禁用密码方式，只认OAuth或Personal Access Token（后者需在Gitee个人设置里生成，并填到WebStorm的Gitee账户配置里）。
真正容易被忽略的是：Gitee新建仓库时默认勾选了“初始化README”，如果你本地项目已经存在且没README，首次push会因历史不匹配而拒绝。此时得先git pull --allow-unrelated-histories，再push——这个细节IDE不会提示，全靠命令行补位。
