Sublime Text 找不到 git 命令需先确认系统 Git 是否可用，再在设置中显式指定 git_command 路径；插件仅在 Git 仓库根目录生效；官方插件偏命令行操作，SideBarGit 强化侧边栏交互；中文路径问题需配置 Git 的 core.quotepath、core.autocrlf 和 i18n.logoutputencoding。
Sublime Text 找不到 git 命令？先确认系统级 Git 是否可用
Sublime 的 Git 插件（如 Git 官方插件或 SideBarGit）本质是调用系统命令行的 git，不是自带 Git。如果右键菜单里没有 Git 选项，或执行时提示 git: command not found，大概率是 Sublime 没读到你的 PATH 环境变量。
Mac/Linux 用户注意：launchctl setenv PATH 或修改 ~/.zshrc 不一定对 GUI 应用生效；推荐在 Sublime 的 Preferences → Settings – User 中显式指定：
{
"git_command": "/usr/local/bin/git"
}
Windows 用户请确认安装 Git 时勾选了「Add Git to PATH」，若没勾选，可手动填入类似 C:\Program Files\Git\bin\git.exe（注意双反斜杠或使用正斜杠）。
- 用终端/命令行运行
which git（macOS/Linux）或where git（Windows）查真实路径 - 不要填错成
git-cmd.exe或git-bash.exe—— 那些是外壳启动器，不是 Git 二进制本身 - 改完设置后必须重启 Sublime，热重载不生效
装了 Git 插件但右键没反应？检查项目是否在 Git 仓库根目录
Sublime 的官方 Git 插件默认只在「当前文件所属的 Git 仓库根目录下」才激活上下文菜单和命令面板选项。它不会递归扫描父目录，也不会在子模块或未初始化的文件夹中启用。
典型表现：打开一个 .js 文件，右键无 Git 子菜单；但用 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（Mac）呼出命令面板，输入 Git: 却能看到一堆命令 —— 这说明插件已加载，只是上下文未匹配。
- 确保你打开的是仓库根目录下的文件，或整个文件夹是用
File → Open Folder…加载的 - 检查当前目录是否存在
.git/文件夹（不是.git文件，那是 submodule 引用） - 如果项目是通过符号链接进入的，某些版本 Sublime 会因路径解析失败而忽略 Git 状态
Git 插件 vs SideBarGit：功能差异和适用场景
官方 Git 插件（Package Control 可搜到）提供命令行式操作：提交、推送、拉取、查看 diff 等，全部走命令面板或快捷键，适合习惯 CLI 流程的人；SideBarGit 则强化侧边栏交互，支持右键直接 add/reset/commit 当前文件或文件夹，更适合视觉化操作。
两者不冲突，可共存，但配置项不同：
- 官方
Git插件依赖git_command和git_timeout（超时秒数，默认 4），大仓库建议调高 -
SideBarGit需额外配置git_binary（同git_command），还支持ignore列表屏蔽特定文件类型 - 如果你常用
git stash或git rebase -i，官方插件更可控；想快速暂存某个 CSS 文件再点一下 commit，SideBarGit更顺手
中文路径/文件名乱码、提交失败？重点看 Git 的 core.autocrlf 和 i18n.logoutputencoding
Windows 上 Sublime 用 Git 插件提交含中文的文件名时，常报错 fatal: Path 'xxx' exists on disk, but not in the repo，或日志里显示问号乱码。这不是 Sublime 的 bug，而是 Git 自身对路径编码的处理问题。
解决需从 Git 配置入手：
- 全局设置：运行
git config --global core.quotepath false（让 Git 日志显示原始路径，而非转义） - Windows 用户加：
git config --global core.autocrlf false（避免换行符干扰路径识别） - 若仍见乱码，再设：
git config --global i18n.logoutputencoding utf-8（部分旧 Git 版本需要） - Sublime 本身编码设为 UTF-8（
File → Reopen with Encoding → UTF-8），且确保文件系统路径不含非法字符
这些配置改完后，Sublime 下次调用 git status 或 git add 就能正确识别中文路径了 —— 但注意，团队协作时需同步告知他人这些配置，否则 push 后别人 pull 可能出错。
