sublime text 中 git 命令不生效主因是 gui 环境未加载系统 path，macos/linux 需配置 ~/.zprofile 或 ~/.profile 并重启 dock/重登录，windows 需确认 git 安装时勾选“add to path”；插件仅从当前编辑文件路径向上查找 .git 目录，不识别项目视图；提交无响应多因 core.editor 冲突或 hooks 阻塞；git 插件与 gitsavvy 务必二选一，避免命令覆盖。
Sublime Text 里 Git 命令不生效，git 命令找不到
根本原因是 Sublime 没读到系统 PATH，尤其 macOS 和 Linux 下 Shell 启动方式不同，GUI 应用默认不加载 ~/.zshrc 或 ~/.bash_profile 里的环境变量。
实操建议：
- macOS：在终端执行
launchctl setenv PATH $PATH（仅当前会话），或更稳妥地——用~/.zprofile设置 PATH 并重启 Dock：killall Dock - Linux（GNOME）：编辑
~/.profile，确保export PATH=...存在且生效，然后重新登录桌面 - Windows：检查
Git是否勾选了 “Add Git to PATH”（安装时选项），没勾选就重装或手动把C:\Program Files\Git\cmd加进系统环境变量 - 插件配置里别硬写绝对路径，优先让插件自动探测
git，除非你明确知道二进制位置（比如/usr/local/bin/git）
Sublime Git 插件显示 “No git repository found” 却明明在项目根目录
不是路径问题，是插件只认 .git 目录是否在“当前打开的文件所在目录向上逐级查找”的路径中。它不看 Sublime 的项目文件夹（.sublime-project），也不看你是不是从终端 cd 进来的。
实操建议：
- 确认你正在编辑的文件，其完整路径是否在 Git 仓库内 —— 比如你打开了
/Users/a/project/src/main.py，那插件会从该路径开始往上找.git，直到根目录 - 如果项目是子模块或嵌套仓库，确保
.git是真实目录（不是.git文件指向外部），否则插件识别失败 - 用快捷键
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（macOS），输入Git: Status测试；若报错，再用终端进到同级目录运行git status验证是否真能识别 - 不要依赖侧边栏“文件夹”图标判断 —— Sublime 可以添加任意文件夹为项目视图，但 Git 插件不认这个
执行 Git: Commit 后没反应，或者提交信息窗口空白
常见于插件未正确绑定编辑器行为，或 Git hooks（比如 prepare-commit-msg）阻塞了流程，也可能是因为 Sublime 默认的 commit message 编辑器没配好。
实操建议：
- 检查插件设置：
Preferences → Package Settings → Git → Settings – User，确认有"git_commit_command": "git commit"（默认值），不要改成带-m的一次性命令 - 禁用自定义
core.editor：终端执行git config --unset core.editor，避免 Git 尝试调起 Vim/VSCode 而卡住 - 如果用了 husky 或其他 hook，临时关掉测试：
git commit --no-verify -m "test"，看是否恢复响应 - 提交窗口空白？多数是 Sublime 没加载好
Git Commit Message语法高亮 —— 确保已安装GitSavvy或原生 Git 插件配套的 syntax definition，或手动选择右下角语言为Plain Text
Sublime Git 插件和 GitSavvy 冲突，命令重复或失效
两者都监听 git 操作，但 GitSavvy 更重、功能更多，而原生 Git 插件轻量但维护停滞。共存时容易抢 command key binding 或覆盖状态栏信息。
实操建议：
- 二者不要同时启用：禁用原生
Git插件（Preferences → Package Control → Disable Package → Git），只留 GitSavvy —— 它自带所有基础命令，还支持 blame、rebase、stashing 等 - GitSavvy 启动慢？删掉
Preferences → Package Settings → GitSavvy → Settings – User里多余的"git_binary"配置，让它自动发现 - 如果坚持用原生 Git 插件，务必卸载 GitSavvy，否则
Git: Status可能返回空，或Git: Diff打不开新 tab - 注意 GitSavvy 的快捷键默认是
ctrl+shift+h（history）、ctrl+shift+s（status），和原生插件的ctrl+shift+p → Git: ...不冲突，但面板行为逻辑不同
Git 仓库路径识别、环境变量加载、插件职责边界，这三个地方最容易反复出问题。改完记得重启 Sublime，别信“重载插件”能解决 PATH 或语法绑定问题。
