sublime text 的 git 插件仅封装系统 git 命令，限单仓库操作，需手动配置 path 和项目根目录；多仓库管理、分支可视化及三方冲突解决必须依赖 sublime merge。
Sublime Text 的 Git 插件到底能干什么
它只负责单仓库、命令行封装式操作，不管理多仓库、不渲染分支图、不提供冲突编辑能力。右键菜单里的 Git: Status 或快捷键 Ctrl+Shift+G 仅对当前文件所在目录下最近的 .git 生效——如果侧边栏高亮的是 src/utils/，但 .git 在上三级 ~/proj/，插件就找不到仓库，Git 菜单项直接消失。
常见错误现象：点 Git: Commit 没反应、Git: Pull 报错 “not a git repository”、终端里 git status 正常但插件报错。这不是插件坏了，而是 Sublime 启动时没继承 shell 的 PATH（尤其 macOS zsh 或 Windows Git for Windows 安装路径未加入系统环境变量）。
- 别同时装
SideBarGit和官方Git插件——两者劫持右键菜单，Commit 可能点不动，且错误被吞掉 - 插件不处理三方合并，遇到
CONFLICT (content): Merge conflict in xxx就卡住，不会弹窗、不跳转、不提示下一步 - 它不读
.gitattributes里的merge=ours等策略，也不识别子模块嵌套结构
为什么必须用 Sublime Merge 解决冲突
Sublime Text 不是三方合并工具，所有所谓“Sublime 内解决冲突”的方案，本质都是绕过 Git 的 mergetool 协议，靠手动删标记 + git add 硬扛——漏掉一个 就导致 commit 失败，大文件或嵌套冲突时 <code>Find All 直接卡死。
真正起作用的是独立应用 Sublime Merge：它原生支持 $BASE/$LOCAL/$REMOTE/$MERGED 四参数传入，界面分四栏（祖先 / 本地 / 远程 / 合并结果），每个冲突块上方有小三角图标，点一下就整块接受，不靠手敲、不靠复制粘贴。
- 配置三步缺一不可：
git config --global merge.tool sublime_merge、git config --global mergetool.sublime_merge.cmd（macOS 推荐完整路径）、git config --global mergetool.trustPrompt false - 验证是否生效：终端运行
git mergetool，立刻唤起窗口才算通；若弹 vim，说明配置未加载或$MERGED路径为空 - rebase 场景下
$BASE可能为空，此时加--no-prompt参数绕过：git mergetool --no-prompt
Sublime Merge 配置最容易错的三个地方
90% 的失败源于配错、漏关、路径空格没转义。不是工具不行，是命令没跑对。
Windows 用户若用 smerge 命令而非 subl，必须用这个格式：git config --global mergetool.sublime_merge.cmd 'smerge merge "$BASE" "$LOCAL" "$REMOTE" "$MERGED" --wait'；macOS 若安装在 /Applications/Sublime Merge.app，路径含空格，必须写成：'/Applications/Sublime\ Merge.app/Contents/SharedSupport/bin/smerge "merge" "$LOCAL" "$REMOTE" "$BASE" "$MERGED" --wait'。
-
mergetool.trustPrompt false必须设，否则每次卡在Hit return to start merge tool，按回车也没反应 - 工具名必须统一：设
merge.tool sublime_merge，就不能在 cmd 里写smerge；反过来，若注册了smerge工具名，就得用git config merge.tool smerge - 保存 ≠ 解决：Sublime Merge 里按
Cmd+S只是写回磁盘，Git 仍认为文件处于both modified状态，必须回到终端执行git add <filename></filename>
多仓库怎么管才不乱
Sublime Text 本身没有工作区概念，也不可能聚合显示多个仓库状态。想实现类似 VSCode 的统一 Git 面板，唯一正解是把 Sublime Merge 当作中心——它原生支持 Workspace，可一次性加载任意数量本地仓库，每个以标签页并列，左侧 Repositories 面板永久列出全部已添加仓库。
添加方式很简单：菜单 Repository → Add Repository…，选中任意含 .git 的目录即可，不限层级（~/work/foo/.git 和 ~/work/bar/client/.git 可共存）；分支可视化在左上角 Branches 面板，带颜色标记和提交链，点击直接切换或比较。
- 批量同步：按住
Ctrl（Win/Linux）或Cmd（macOS）多选仓库，右键可一键Pull、Fetch - Sublime Text 仅作为编辑器配合：在 Sublime Merge 中右键文件 →
Open in Sublime Text，改完保存后回 Merge 点Refresh即同步状态 - 别指望插件自动发现嵌套仓库（比如 monorepo 里的 packages/*），每个都要手动
Add Repository…
