直接在WebStorm内置Terminal执行git checkout或git switch切换分支，需确保当前目录为含.git的项目根目录；若路径错误会报“not a git repository”，可用pwd和git rev-parse --is-inside-work-tree验证；切远程分支时git checkout自动创建本地分支并设upstream，而git switch需显式加-c和--track参数；切换后右下角分支名未更新需手动刷新Version Control面板或等待IDE自动同步。
直接在 WebStorm 内置 Terminal 里执行 git checkout 或 git switch 就行，但必须确保当前目录是项目根目录（含 .git），否则命令无效或报错。
终端切换分支前，先确认是否在正确路径
WebStorm 的 Terminal 默认打开位置不一定是项目根目录，尤其当你用 Add Content Root 加了多个子目录时，初始路径可能是子文件夹。此时运行 git checkout main 会提示 fatal: not a git repository 或 error: pathspec 'main' did not match any file(s) known to git。
- 输入
pwd看当前路径，应显示项目最外层目录（即包含.git文件夹的那层） - 如果不对，用
cd ..逐级返回，或直接cd /path/to/your/project - 运行
git rev-parse --is-inside-work-tree，输出true才说明 Git 工作区就绪
git checkout 和 git switch 的实际区别
两者都能切本地分支，但行为有关键差异：前者还能切 commit 或新建分支，后者更专注、更安全，且默认不创建新分支。
- 切已有本地分支：
git checkout feat/login和git switch feat/login效果一致 - 切远程分支（如
origin/feat/api）：git checkout feat/api会自动创建本地分支并设置 upstream；git switch -c feat/api --track origin/feat/api才等效，漏掉-c和--track会报错 -
git switch不能用于检出单个文件或 commit，遇到error: ambiguous argument时优先换回git checkout
终端切分支后，WebStorm 界面没更新？
常见现象：命令行显示 Switched to branch 'dev'，但右下角分支名还是旧的，文件也没变 —— 这不是同步延迟，而是 WebStorm 没主动刷新 Git 状态。
- 手动触发刷新：
Ctrl+Shift+V（Windows/Linux）或Cmd+Shift+V（macOS）唤出 Version Control 面板，点左上角刷新按钮 - 或者终端里执行
git status后，WebStorm 通常会在几秒内自动同步右下角分支名 - 极端情况（如 HEAD 分离）：
git log -1看输出是否带HEAD detached at xxx，是的话需先git switch -C dev强制重建分支指针
终端命令最可靠，但别忽略 WebStorm 的 Git 状态缓存机制：它不会实时监听所有 shell 命令，切换后多看一眼右下角和 git status 输出，比等 IDE 自动反应更省时间。
