必须先确认系统git是否可用且sublime能调用它，再确保在含.git的项目根目录打开文件夹，最后安装wbond维护的官方git插件并正确配置git_command路径。
Git 插件装完没反应？检查 git 命令是否在系统 PATH 里
Sublime Text 本身不带 Git 功能，依赖插件（如 Git 官方插件或 SideBarGit）调用系统 git 命令。如果右键菜单没出现 Git 选项，或者按 Ctrl+Shift+P 输入 Git: Quick Commit 找不到命令，大概率是 Sublime 找不到 git 可执行文件。
验证方法：打开终端（macOS/Linux）或命令提示符（Windows），运行：
which git # macOS/Linux where git # Windows
如果返回路径（如 /usr/local/bin/git 或 C:\Program Files\Git\bin\git.exe），说明已安装；否则需先安装 Git 并确保勾选「Add Git to the system PATH」（Windows 安装时）或手动把 git 目录加进 shell 的 PATH。Sublime 默认读取的是登录 shell 的环境变量，某些桌面环境（如 Ubuntu GNOME）可能不会自动加载 ~/.bashrc，这时得在 Sublime 的插件设置里硬编码路径：
- Preferences → Package Settings → Git → Settings
- 添加：
"git_binary": "/usr/local/bin/git"（替换成你自己的路径）
右键提交后提示 “No changes to commit”？确认当前文件属于 Git 仓库根目录下
Sublime 的 Git 插件默认只对“当前文件所在 Git 仓库根目录”生效。如果你在子目录里打开一个文件，但仓库根在上两级，插件可能无法识别工作区状态，导致 Git: Quick Commit 灰掉或报空变更。
快速判断方式：在 Sublime 中打开任意文件，按 Ctrl+Shift+P 输入 Git: Status，看底部状态栏是否显示分支名（如 main）和修改文件数。不显示？说明 Sublime 没定位到仓库根。
- 确保打开的文件路径在
.git目录的子路径下（可用终端执行git rev-parse --show-toplevel确认） - 不要用“拖拽单个 .js 文件进 Sublime”这种操作启动项目——应通过
File → Open Folder...打开整个仓库根目录 - 如果项目嵌套多层（比如 monorepo），而你只想管理某个子包，可在该子目录下单独初始化
.git，或使用git worktree分离管理
Git: Push 失败说 “No configured push URL”？检查远程分支关联是否建立
即使本地 commit 成功，Git: Push 仍可能失败，常见错误是：fatal: The current branch main has no upstream branch. 这不是 Sublime 的问题，而是 Git 本身要求首次推送必须指定远程分支。
解决方法不是在 Sublime 里点几下就能绕过，得先在终端跑一句：
git push -u origin main
之后 Sublime 的 Git: Push 才能正常触发推送。注意：
-
-u（即--set-upstream）只用一次，它把本地分支和远程origin/main绑定 - 如果远程分支名不是
main（比如叫master或develop），请替换对应名称 - Sublime 不会帮你创建远程仓库——
git remote add origin https://...这步必须提前完成
中文路径或文件名乱码、提交失败？别碰 core.autocrlf，改 core.precomposeunicode
macOS 用户在 Sublime 里提交含中文名的文件时，偶尔遇到 error: unable to index file 'xxx.md' 或状态栏显示乱码文件名，根源是 Git 对 Unicode 路径的预处理方式与 macOS 的 HFS+（或 APFS）文件系统不一致。
这不是编码格式问题，也不是换行符惹的祸，core.autocrlf 在这里完全无关。真正有效的配置是：
git config --global core.precomposeunicode true
这个设置告诉 Git 把 Unicode 组合字符（如带声调的字母、中文）提前“分解”成标准形式，避免和 macOS 底层文件系统表示方式冲突。Windows 和 Linux 用户基本不用管这项。
顺带一提：Sublime 自身对 UTF-8 支持良好，只要文件保存时编码选的是 UTF-8（底部状态栏可见），就不会因编辑器引发乱码；真正卡住的环节永远在 Git 和 OS 的交互层。
Git 仓库路径里有空格、括号、emoji，这些都没问题；但如果你用的是老旧 Git 版本（precomposeunicode 可能未生效，建议升级到最新稳定版。
