先确认 sublime text 版本是 st4 还是 st3，再根据版本选择对应 installation.py 脚本；若失败则手动安装：退出程序、清空 installed packages/ 下旧文件、下载并拖入 package control.sublime-package 文件、重启后验证命令生效。
Package Control 装不上？先确认 ST4 还是 ST3
装插件卡在第一步，90% 是因为没搞清自己用的是 Sublime Text 4 还是 3。ST4（截至 2026 年 8 月主流版本）和 ST3 的 installation.py 脚本不兼容，用错就静默失败——命令面板里搜得到 Package Control: Install Package，点开却没反应，控制台也不报错。
操作前必须做这一步：Help → About Sublime Text，看顶部明确写着 Sublime Text 4 还是 Sublime Text 3。别信安装包名字或旧记忆，版本号写错一个字符，后续全白忙。
- ST4 用户只认官网最新
installation.py脚本（以import urllib.request开头），旧版哈希校验码已失效 - ST3 用户可用带固定
h = '6f4c264a...'的老脚本，但 2026 年新装机基本不用考虑 - 如果不确定，直接走手动安装路径，绕过所有版本判断
手动安装 Package Control：不依赖网络、不拼手速
控制台粘贴失败、代理拦截、SSL 证书报错、复制进不可见 Unicode 字符……这些都让一键脚本变成玄学。手动方式反而更稳，5 分钟搞定：
- 完全退出 Sublime Text（任务管理器/活动监视器里确认进程消失）
-
Preferences → Browse Packages… → 关掉窗口 → 向上退一级进
Installed Packages/目录 - 清空该目录下所有含
Package Control字样的文件（残留旧版会劫持命令通道） - 浏览器打开 https://www.php.cn/link/2e5d5f65d3ef778b01366907d1f14445，下载这个文件
- 把下载好的
Package Control.sublime-package文件直接拖进Installed Packages/（不改名、不解压、不放进Packages/目录） - 重启 Sublime Text
验证是否真生效：按 Ctrl+Shift+P → 输入 Package Control: List Packages，能列出一堆包名才算成功。菜单里有选项 ≠ 能跑命令。
初学者只装这 4 个插件，够用且零冲突
新手常犯的错是搜“十大必备插件”全装上，结果快捷键打架、设置互相覆盖、某天突然所有插件失效。2026 年实测高频刚需就这四个，彼此无依赖、不抢键位、不改底层配置：
-
SideBarEnhancements：右键菜单加刷新、新建文件/文件夹、复制路径等，告别手动切终端 -
GitGutter：行首显示 Git 修改状态（+ - △），不装 Git 插件也能直观看到改了啥 -
Emmet：写 HTML/CSS 时敲div.container>ul>li*3回车直接展开，省掉重复标签 -
AutoFileName：输入img/src="会自动弹出当前目录文件补全，防手误打错路径
装法统一：按 Ctrl+Shift+P → Package Control: Install Package → 输入插件名回车。别装“汉化包”或“激活补丁”，它们会篡改 Preferences.sublime-settings，导致后续插件安装失败或高分屏渲染异常。
装完插件没反应？检查这三个地方
插件列表里明明显示已安装，但功能就是不触发，大概率不是插件问题，而是环境或权限卡点：
- 部分插件（如
GitGutter）依赖系统 PATH 里的git命令，终端里能运行git --version，Sublime 才认得；macOS 用户尤其注意 Shell 初始化文件（~/.zshrc）是否导出了正确路径 - Windows 用户若用企业防火墙或杀毒软件，可能拦截
plugin_host.exe网络请求，表现为插件列表加载超时或空白 - 插件启用状态被意外关闭：按
Ctrl+Shift+P→ 输入Package Control: Enable Package→ 选刚装的插件名，确保前面有勾
真正麻烦的从来不是“怎么装”，而是装完发现它不动——这时候要盯住日志，而不是重装。按 Ctrl+` 呼出控制台，任何插件加载失败都会在这里打印错误，比如 ImportError: No module named 'git' 或 UnicodeDecodeError，顺着它查比瞎试快得多。
