IntelliJ IDEA 原生支持批量切换多个 Git 项目分支，需在 Settings → Version Control → Git 中勾选“Execute branch operations on all roots”；该设置仅对已显式添加至 Version Control Roots 列表且类型为 Git 的项目生效，未注册或类型为 None 的项目将被跳过，且单个项目操作失败不影响其余项目继续执行。
IntelliJ IDEA 原生支持批量切换多个 Git 项目的分支，但默认是关闭的——只要打开对应开关，Checkout、Merge、Pull 等操作就会自动作用于所有已注册的 Git 仓库根目录。
IDEA 设置 Version Control → Git → “Executor branch operations on all roots”
这个选项才是批量切换的开关，不是“多根项目”本身决定的。很多用户误以为只要把多个项目加为 project root 就能自动同步分支，其实不勾选它，IDEA 仍只对当前选中项目生效。
- 路径：
Settings（或Preferenceson macOS）→Version Control→Git - 必须勾选
Executor branch operations on all roots（注意拼写，部分旧版显示为Execute branch operations on all roots） - 该设置仅对「已被 IDEA 识别为 Git 仓库」的项目根目录生效；未添加到
Version Control列表的目录会被跳过 - 勾选后，右键任意项目 →
Git→Branches→ 选择目标分支 →Checkout Revision，所有项目将同时切换
为什么有些项目没被批量切换？检查 Version Control 的 Roots 列表
IDEA 不会自动扫描子目录下的 Git 仓库，必须显式添加。即使你用 File → Add Project Root 加了多个目录，也不代表它们都被纳入 Git 管理范围。
- 进入
Settings → Version Control，左侧列表应显示每个项目根路径，并在右侧 Type 列标注Git - 如果某项目显示为
None或空白，说明 IDEA 没把它当 Git 仓库：点击+→Directory→ 手动添加该路径 → Type 选Git - 常见漏掉的情况：子模块（submodule）根目录、独立前端项目（如
web-ui/）、脚手架生成的嵌套工程 - 添加后需重启 IDE 或点击
Refresh，否则分支操作可能仍不生效
git checkout 失败时，批量操作会中断还是继续？
IDEA 的批量分支切换是“尽力而为”：某个项目执行 git checkout 报错（比如有未提交修改、冲突或 detached HEAD），它会弹出错误提示，但**不会停止其他项目的切换**——其余项目照常执行。
- 典型报错包括：
error: Your local changes to the following files would be overwritten by checkout、error: pathspec 'xxx' did not match any file(s) known to git - 这意味着你得逐个处理失败项目，不能依赖“全成功”反馈
- 如果想规避这类中断，建议批量操作前统一执行
git stash（可写脚本预处理），或先用git status --porcelain扫描脏工作区 - 注意：IDEA 不会自动
git pull，切换分支后若需最新代码，仍要单独触发Pull（同样受 “on all roots” 控制）
真正容易被忽略的是 Roots 列表的完整性——它不像文件系统那样“自动发现”，而是完全依赖手动注册。哪怕只漏一个关键服务模块，批量切换就等于白设。
