PhpStorm不自带Git，需手动配置系统Git路径：Windows填Git\cmd\git.exe，macOS填/usr/bin/git，Test成功显示版本号即生效；项目根须有.git文件夹；提交前需Add文件并填写Commit Message；切换分支需Checkout as new local branch。
PhpStorm 本身不提供 Git，它只是调用你系统里已安装的 Git 可执行文件；没装 Git 或路径配错，所有提交、切换分支操作都会失败——先确认 git --version 能在终端跑通，再进 PhpStorm 配置。
怎么让 PhpStorm 找到你的 Git
PhpStorm 不自带 Git，必须手动指定可执行文件路径。Windows 默认是 git.exe（通常在 Git\mingw64\bin\git.exe 或 Git\cmd\git.exe），macOS/Linux 是 /usr/bin/git 或 /opt/homebrew/bin/git（Homebrew 安装）。
- 打开
Settings / Preferences → Version Control → Git - 在
Path to Git executable栏粘贴完整路径，别只写git - 点
Test按钮，看到版本号才说明配置成功 - 如果点 Test 报错 “Cannot run program ‘git’”，大概率是路径错、Git 没装、或 Shell 环境变量没同步到 GUI 应用（macOS 尤其常见，改用绝对路径更稳）
提交代码前必须做的三件事
直接点 Commit 按钮却没反应？多半卡在这三步里：
- 项目根目录下得有
.git文件夹（即已git init或git clone过），PhpStorm 不会自动初始化仓库 - 文件得是“受控状态”：新文件要先
git add（PhpStorm 里右键 →Git → Add，或勾选 Commit 对话框里的文件前复选框） - 提交信息不能为空：Commit 对话框里
Commit Message至少输一行文字，否则按钮灰色不可点
小技巧：勾选 Amend commit 可修改上一次提交（比如补文件或改日志），但别在已推送到远程后还这么干。
立即学习“PHP免费学习笔记（深入）”；
切换分支时常见的“找不到分支”问题
点 VCS → Git → Branches…，列表里只有 master 或 main，其他远程分支（如 origin/feature/login）不显示？这不是 PhpStorm 的 bug，而是分支还没被本地跟踪。
- 先确保远程分支真实存在：终端运行
git ls-remote --heads origin看输出 - 在 PhpStorm 的 Branches 弹窗里，点右上角
Origin标签页，找到目标分支，右键 →Checkout as new local branch - 别直接双击
origin/xxx—— 那是只读引用，双击只会报错 “Cannot checkout remote branch” - 如果切换后发现文件没变，检查右下角状态栏是否真显示了新分支名；有时 UI 滞后，可手动触发
VCS → Git → Repository → Refresh status
为什么刚切完分支，.gitignore 里排除的文件又冒出来了
这是 Git 的底层机制导致的：当你切换到一个不含某些文件的分支时，如果这些文件当前被 .gitignore 排除，且从未被 Git 跟踪过，Git 就不会动它们——它们会原样留在工作区，看起来像“凭空出现”。
- 不是 PhpStorm 的问题，
git status在终端里也会显示它们为untracked - 若想彻底清理，用
git clean -fd（慎用！会删所有未跟踪文件） - 更安全的做法：在项目初始化阶段就用
git add -f .gitignore确保忽略规则被提交，避免不同分支对同一文件的跟踪状态不一致
分支切换的本质是重置暂存区和工作区，但 Git 只管它“知道”的文件；那些被忽略又没入过历史的文件，就游离在 Git 的视线之外——这点容易被 IDE 隐藏掉，得心里有数。
