Sublime Text 4 的 Git 状态未同步是因默认不监听文件系统变更，仅在打开/保存/右键时单次查找.git，Monorepo中易因路径错位、子模块解析失败或启动时PATH缺失导致失效。
Git 状态未同步不是插件“卡了”，而是 Sublime Text 4 默认不监听文件系统变更，且对嵌套深度、子模块、忽略规则等无主动感知能力。它只在打开/保存/右键触发时查一次 .git，之后就不再刷新。
为什么 Git 状态在 Monorepo 里总显示过期？
Sublime 的官方 Git 插件本质是命令行封装器，不运行 git status --porcelain 守护进程，也不订阅 inotify/fsevents。你在终端执行 git commit 或其他工具（如 VS Code、Sublime Merge）改了状态后，Sublime 不会自动重载。
- Monorepo 中常含大量
node_modules、dist、子模块目录，但插件仍会尝试扫描整个工作区，导致git status调用超时或被截断 - 项目根目录若不在侧边栏高亮路径的祖先链上（比如你只打开了
packages/ui，而.git在./），插件根本找不到仓库，直接静默失效 -
.gitignore或.sublime-project里的"folder_exclude_patterns"只影响索引，不影响Git插件调用git命令的路径范围——它仍会从当前文件所在目录向上找.git
如何让 Git 状态真正“跟得上”？
靠插件自动刷新不现实，必须控制触发时机 + 缩小作用域 + 避开干扰项：
- 始终通过
Project > Open Project加载完整的.sublime-project文件，而不是直接拖文件夹进 Sublime；确保"folders"数组中只包含真正需要编辑的子包路径（如"packages/backend"），而非整个 Monorepo 根目录 - 在
.sublime-project中显式设置"git_path"，避免 PATH 透传失败："settings": { "git_path": "/usr/local/bin/git" } - 禁用插件默认的“自动刷新”假象：关闭
"git_status_in_view_title"和"git_status_in_status_bar"，它们只是缓存值，反而制造误导 - 用快捷键
Ctrl+Shift+G（Windows/Linux）或Cmd+Shift+G（macOS）手动刷新状态，比等它“自己更新”更可靠
子模块（Submodule）下 Git 状态为何总是灰色/不可用？
因为官方 Git 插件只认第一层 .git，遇到子模块时，它在 packages/lib/.git 找到的是一个文件（非目录），内容为 gitdir: ../.git/modules/packages/lib，插件无法解析该路径并 fallback 到主仓库，于是直接放弃。
- 不要指望右键子模块目录能弹出
Git: Commit—— 它大概率不会出现 - 想操作子模块，必须先在终端进入该目录，或用
GitSavvy插件（它专门处理git submodule命令） - 如果子模块只是只读依赖，建议在
.sublime-project中将其从"folders"移除，或加"follow_symlinks": false防止误扫
Git 状态偶尔正确、偶尔消失，最可能漏掉什么？
不是配置问题，是启动方式问题。Sublime Text 4 在 macOS/Linux 下若从 Dock 或桌面图标启动，完全不继承 shell 的环境变量（包括 PATH 和 HOME），导致 git 命令根本找不到，所有 Git 功能静默降级。
- macOS 用户务必从终端启动：
open -a "Sublime Text"或subl . - Linux 用户检查桌面环境是否加载了
~/.profile或~/.bashrc；GNOME 用户可改写 desktop 文件，在Exec=行前加env "PATH=$PATH:/usr/local/bin" - Windows 用户确认 Git 安装时勾选了“Add Git to the system PATH”，且 Sublime 启动前没被旧版 CMD 环境污染
