WebStorm需系统Git支持，路径配置错误会导致Git功能不可用；新建项目应勾选“Create Git repository”确保.git在根目录；文件颜色标识Git状态，需依色操作；Commit前必须Pull避免冲突；.gitignore和add范围须精准控制。
Git没装或路径不对，WebStorm根本用不了Git
WebStorm本身不带Git，它只是调用你系统里装好的git.exe（Windows）或git命令（macOS/Linux）。如果没装Git，或者装了但WebStorm找不到，所有Git菜单都是灰的，点不动。
- 先去git-scm.com下最新版Git，安装时勾选「Add Git to PATH」（Windows默认会加，macOS用Homebrew装的通常也OK）
- 打开WebStorm →
File→Settings（macOS是Preferences）→Version Control→Git - 看
Path to Git executable字段：如果显示路径且右边有绿色“Test”按钮提示“Git version X.X.X”，说明OK；如果红字报错或为空，就手动点右侧“…”找git.exe（常见路径：C:\Program Files\Git\bin\git.exe） - 别信“自动检测”——尤其在重装Git、升级WebStorm后，这个字段常被清空或指向旧版本
新建项目时勾选“Create Git repository”最省事
很多人手动右键“Git → Initialize Repository”，结果发现.git目录建在了错误层级（比如建在src里而不是项目根目录），后续拉远程库、设remote全得重来。
- 新建项目时，在创建向导里直接勾选
Create Git repository，WebStorm会把.git建在项目根目录，且自动启用Git集成 - 已存在的本地项目？别手抖点“Initialize”——先确认当前打开的是否为**项目根目录**（即包含
src、pom.xml或package.json的那层）。如果不是，关掉项目，重新以正确根目录打开再操作 - 初始化后立刻看右下角状态栏：如果显示
main或master分支名，说明Git已就位；如果还是灰色，检查是否误点了“Enable Version Control Integration”却选了“None”
文件颜色乱七八糟，其实是Git状态在说话
WebStorm用颜色直白告诉你每个文件的Git状态，但很多人看不懂，结果该提交的没提交，该忽略的推上去了。
-
绿色：新文件已
git add（即加入暂存区），下次提交会带上 -
蓝色：已跟踪文件被修改过，但还没
add，也不会被提交 -
红色：文件在项目里，但Git完全不知道它存在（即“Unversioned”），比如你新建了
config.local.js但没点“Add to VCS” - 灰色或黑色：和HEAD一致，干净无改动
- 特别注意：
.idea/workspace.xml、node_modules/这类文件，即使变绿也不该提交——进Settings → Version Control → Ignored Files里加忽略规则，或直接在项目根目录加.gitignore
Commit前不Pull，大概率撞上冲突还得手动解
不是所有冲突都弹窗提醒。有时候Push失败才看到“non-fast-forward”，这时候远端已有别人提交，你的推送被拒，必须先Pull再处理合并逻辑——而WebStorm默认Pull是merge，不是rebase。
- 养成肌肉记忆：右键项目根目录 →
Git → Repository → Pull，等进度条走完再写代码、再Commit - 如果多人高频协作，建议改Pull策略：进
Settings → Version Control → Git，勾选When changes are pushed to remote repository, update local branches automatically，并把Update method设为Rebase（更线性，减少无意义merge commit） - 遇到冲突别硬点“Accept Yours”——点开
Version Control → Log窗口，看谁改了哪行，再双击冲突文件，用WebStorm内置三栏对比工具（左：远端，中：当前，右：本地）精准取舍
Git集成不是开关一开就万事大吉，真正卡住人的永远是路径、作用域和时机——尤其是git add范围、Pull时机、.gitignore生效层级，这三处错一个，后面全是补救成本。
