GitGutter装不上，首要检查Package Control是否正常：按Ctrl+Shift+P输入“Package Control: List Packages”，若命令不存在则未安装，存在但报错或无响应则已失效；重装需执行官网脚本并完全退出Sublime后重启；安装时仅搜“GitGutter”（无下划线、无_sublime、无版本号）；启用需满足三前提：系统git可用、项目根目录含.git文件夹、当前文件已保存；图标异常多因主题或字体不兼容，live_mode需手动开启并重启。
GitGutter 装不上？先看 Package Control 活没活
装 GitGutter 失败，90% 是因为 Package Control 本身没起作用。别急着重装插件，先验证它是否在线：
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: List Packages - 如果命令不存在，说明 Package Control 没装；如果存在但列表为空或报错，说明它已失效
- 重装方法：打开控制台（
Ctrl+`），粘贴官方安装脚本，回车执行，**然后必须完全退出 Sublime Text 再重新打开**
安装 GitGutter 时搜不到？名字就是 GitGutter
在 Package Control 的安装界面里，只输 GitGutter 四个字母——不加下划线、不加 _sublime、不加数字后缀。任何带这些字符的变体（比如 GitGutter4 或 GitGutter_sublime）都搜不到，因为插件早已停更旧命名，当前唯一有效名称就是 GitGutter。
作者是 dhg（Drew Hays），GitHub 仓库是 jisaacks/GitGutter。装完后不会自动生效，必须满足后续条件。
装完没图标？三个硬性前提缺一不可
GitGutter 不是“装完就亮”，它静默启动的前提非常具体：
Github Stars Analyzer
下载
抓取指定 GitHub用户的 Stars 项目，生成标准化中文 Markdown 报告。用户提及「分析 GitHub stars」「导出收藏项目」「汇总 GitHub 星标」「生成 stars 报告」或粘贴含 ?tab=stars 的链接时触发。执行通过 bash...
- 终端能运行
git --version并返回有效版本号（如git version 2.40.1） - Sublime 是通过
File → Open Folder…打开整个项目根目录，且该目录下**直接存在.git文件夹**（不是子目录里有） - 当前编辑的文件**已保存过**（
Ctrl+S），未保存的缓冲区不触发 diff 检查
常见错误：双击打开单个 .py 文件，哪怕它物理路径在 Git 仓库里，GitGutter 也完全不启动。
图标错位/全灰/不显示？先换主题和字体
侧边栏图标异常，大概率不是插件问题，而是渲染环境不匹配：
- 临时切换到默认主题：
Preferences → Theme → Default.sublime-theme，恢复即说明当前主题缺失git_gutterscope 支持 - 检查字体是否等宽：在
Preferences → Settings中加入"font_face":"Fira Code"（macOS/Linux）或"font_face":"Consolas"（Windows） -
git_binary必须设绝对路径，且改完要**完全退出 Sublime 再重启**——它只在启动时读一次配置 - 光标停在修改行，按
Ctrl+Alt+Shift+P（Win/Linux）或Cmd+Alt+Shift+P（macOS）调出 scope 名，底部应含markup.inserted.git_g类字样
live_mode 默认关闭，修改行不标颜色；如需实时标记内容变更（橙点），得在用户设置里显式加 "live_mode": true 和 "show_gitgutter_in_modified_tabs": true，改完仍需重启。
