Package Control 必须先安装并验证生效，否则所有插件操作无效；验证方式是命令面板输入“Package Control: List Packages”并成功列出插件，若报错或无响应需手动安装。
Package Control 装没装对？先看命令面板里有没有 Package Control: Install Package
没这个命令，后面所有插件安装都白搭。ST4 用户尤其容易踩坑：控制台执行了安装脚本但没看到 Package Control: Successfully installed Package Control 提示，大概率是网络超时或证书拦截，此时命令面板里虽然有 Package Control 菜单项，但点不动、搜不到 Install Package。
必须用硬指标验证：
- 按
Ctrl+Shift+P（Mac 为Cmd+Shift+P）调出命令面板 - 输入
Package Control: List Packages并回车 —— 能列出已装插件才算真生效 - 如果报错或无响应，别试第二次，直接走手动安装路径：下载
Package Control.sublime-package文件，拖进Installed Packages/目录（不是Packages/），重启后重试
Git 插件选哪个？GitGutter 和 SublimeGit 定位完全不同
GitGutter 只做一件事：在编辑器行号旁显示 git diff 状态（新增/修改/删除），不提供 commit/push 操作；SublimeGit 是完整 Git CLI 封装，支持从 staging 到 push 全流程，但依赖系统 PATH 中的 git 命令且对中文路径兼容性差。
实际选择看需求：
- 只想一眼看出改了哪几行 → 装
GitGutter，轻量、稳定、无依赖 - 需要在编辑器里完成日常提交流程 → 装
SublimeGit，但务必确认终端里git --version能正常返回，且项目路径不含空格或中文 - 两者可共存，
GitGutter显示状态，SublimeGit处理操作，互不干扰
手动安装旧版插件时，auto_upgrade_ignore 必须加，否则下次启动就被覆盖
比如你通过 git clone --branch v2.1.0 下载了老版本 GitSavvy 放进 Packages/GitSavvy/，不加防护，Package Control 后台检查到新 release 就会静默替换成最新版，连提示都没有。
正确做法：
- 打开
Preferences → Package Settings → Package Control → Settings – User - 在 JSON 里加一行：
"auto_upgrade_ignore": ["GitSavvy"]（插件名大小写必须完全一致） - 保存后彻底退出 Sublime Text（macOS 注意 Activity Monitor 里杀掉残留进程），再重启
- 启动后看控制台是否输出
reloading plugin GitSavvy.xxx，且路径指向你放的文件夹，才算真正加载成功
插件名和文件夹名不一致？Package Control 会直接忽略
GitHub 上仓库名常带前缀，比如 sublimehq-gitignore，但插件注册名是 Gitignore；又比如 Emacs Pro Essentials 在 packagecontrol.io 的注册名是 EmacsProMode。手动安装时若把文件夹命名为 sublimehq-gitignore 或 Emacs Pro Essentials，Sublime 就认不出来。
查准名字的方法只有两个：
- 用
Package Control: List Packages查当前已装插件的准确名称 - 去
packagecontrol.io/packages/插件名页面看 URL 最后一段，比如https://packagecontrol.io/packages/Gitignore→ 文件夹名就是Gitignore
名字不对，哪怕代码完全一样，Sublime 也当它不存在。这点最容易被忽略，尤其是从 ZIP 解压时多了一层目录、或者复制了 GitHub 仓库名而非注册名。
