git插件依赖package control，需先安装适配sublime text版本的package control 4.x；推荐使用官方git插件，避免与sidebargit冲突；git命令找不到是环境变量未透传所致，需通过终端启动或配置path；插件不处理合并冲突，须人工核对。
Git 插件装不上？先确认 Sublime Text 版本和 Package Control 是否就位
Sublime Text 本身不内置 Git 支持，必须靠插件，而几乎所有 Git 相关插件（比如 Git 官方插件、SideBarGit）都依赖 Package Control。如果 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）调不出命令面板，或者输入 Install Package 没反应，说明 Package Control 没装好。
- 去
https://packagecontrol.io/installation复制对应 Sublime 版本的 Python 安装代码，粘贴进 Sublime 的View → Show Console执行 - Sublime Text 4 要求
Package Control4.x，旧版（如 3.3.x）装了也会失效；检查方法：菜单Preferences → Package Control存在即 OK - 别用第三方“汉化包”或“绿色版”，它们常屏蔽或破坏
Package Control的网络请求，导致插件列表空白
装哪个 Git 插件？官方 Git 插件就够用，别堆砌
社区里有十来个 Git 插件，但真正稳定、维护及时、覆盖主干操作的只有 Sublime 官方维护的 Git 插件（作者是 wbond）。它不提供图形化分支面板，但所有命令直通 git CLI，行为可预测，不会掩盖底层错误。
- 安装方式：调出命令面板 → 输入
Package Control: Install Package→ 搜索并选中Git - 装完后，右键文件或文件夹会多出
Git子菜单，含Commit、Push、Diff等；快捷键默认为Ctrl+Shift+H（Log）、Ctrl+Shift+G（Status） - 别同时装
SideBarGit和Git——两者都劫持右键菜单，冲突时Git插件的Commit可能点不动，且错误提示被吞掉 - 该插件不自动识别仓库根目录：如果项目嵌套深（如
~/proj/backend/src），需确保当前打开的文件或侧边栏高亮路径在.git同级或子目录下，否则右键无 Git 选项
git 命令找不到？不是插件问题，是环境变量没透到 Sublime
常见现象：右键 Git → Status 弹窗报错 Unable to find git in your PATH 或直接卡住。这不是插件坏了，是 Sublime 启动时没读到你 Shell 里配置的 PATH（尤其 macOS 上用 zsh、Linux 用 bashrc、Windows 用 Git Bash 自定义路径时极易发生）。
- macOS：如果从 Dock 或 Spotlight 启动 Sublime，它继承的是 login shell 的 PATH；但如果你用终端执行
subl .启动，则 PATH 正常。临时解法：一律改用终端启动 - Windows：确认
git能在 CMD 里运行；若用了 Git for Windows，勾选安装时的 “Add Git to PATH” 选项；若已装错，重装或手动把C:\Program Files\Git\cmd加进系统环境变量 - Linux：检查
~/.profile或/etc/environment是否导出 PATH；Sublime Desktop 文件可能未加载用户 shell 配置，建议用终端启动或修改 desktop 文件的Exec=env PATH=... subl %F
协同场景下，别依赖插件做“智能合并”，冲突必须人工核对
插件能帮你拉取、推送、看 diff，但一旦出现 merge conflict，Git 插件只负责把冲突标记写进文件（ 那种），不会高亮差异块、也不能跳转到冲突行。指望它“一键解决”等于把 Git 当 SVN 用。
- 看到
CONFLICT (content): Merge conflict in xxx.py提示后，立刻停止点击Commit，先切到终端执行git status确认哪些文件未解决 - Sublime 内打开冲突文件，用
Ctrl+R（Goto Symbol）搜快速定位，删掉冲突标记并保留正确逻辑——插件不校验语法，删错一行就 <code>git commit -m "fix"会提交非法内容 - 多人共用一个分支时，每天开工前先
Pull，别攒一天改完再推；插件的Pull功能本质就是git pull --rebase，但如果本地有未提交修改，它会直接失败，不提醒你stash
Git 在 Sublime 里始终是个“透明管道”，它暴露错误，但不替你决策。最常被忽略的，是以为右键点了 Push 就万事大吉——其实网络超时、权限拒绝、pre-push hook 失败时，插件只弹个模糊提示，得看控制台输出里的真实 stderr 才知道卡在哪。
