package control装不上需先确认sublime text版本：st4用户必须用官网以6f4c264a开头的installation.py脚本，st3用户不可混用；唯一有效验证标准是ctrl+shift+p执行package control: list packages能弹出列表（哪怕为空）且install package触发“fetching list of available packages”。
Package Control装不上？先确认ST4还是ST3
2026年绝大多数人用的是Sublime Text 4，但网上大量教程仍混用ST3脚本，导致Package Control: Install Package命令存在却点不动、控制台无报错、命令面板搜不到结果——这不是你网络差，是哈希校验失败后静默退出。
打开Help → About Sublime Text，顶部必须明确显示“Sublime Text 4”。若显示“Build 41xx”或“Build 42xx”，就是ST4；若显示“Build 3xxx”，才是ST3。版本写错一个字，后续所有操作都无效。
- ST4用户必须用官网最新
installation.py脚本（开头含import urllib.request，不含硬编码哈希值） - ST3用户可用带
h = '6f4c264a...'的旧脚本，但不能往ST4里粘 - 菜单里有“Package Control”选项 ≠ 它能工作，只认两个动作：
Package Control: List Packages返回空列表，Package Control: Install Package触发“Fetching list of available packages”
Ctrl+Shift+P输Install Package没反应？检查三个硬点
不是插件没装好，是通道没打通。常见现象：输入后命令面板直接关闭、控制台只刷一行reloading plugin、左下角无任何加载提示。
- 删干净残留：
Preferences → Browse Packages…→ 关闭窗口 → 上一级进Installed Packages/→ 删除所有含Package Control字样的文件（包括Package Control.sublime-package和Package Control.py） - 验证网络通路：在控制台执行
urllib.request.urlopen('https://packagecontrol.io/').getcode()，返回200才算通；返回timeout或报SSL错，换手机热点或关代理 - 查配置干扰：
Preferences → Settings右侧用户配置里，确认没有"http_proxy": ""或"https_proxy": "null"这类非法值
插件装完不生效？语法作用域和路径放错是主因
装完Emmet却不能缩写div>ul>li*3，不是插件坏，是你当前文件没被识别为HTML上下文；装完Python Lint没提示错误，大概率是.py文件没匹配到source.python作用域。
- 看右下角状态栏：显示“Plain Text”或“Text”就说明语法未激活，按
Ctrl+Shift+P输Set Syntax: HTML手动切换 - 路径必须严格对应：
Emmet.sublime-package文件拖进Installed Packages/；而解压后的Emmet/文件夹必须整个拖进Packages/（不是Packages/Emmet/Emmet/这种嵌套） - 检查忽略列表：
Preferences → Settings里搜ignored_packages，确保没把刚装的插件名写进去（比如"Emmet"或"GitGutter"）
手动安装插件时最容易踩的坑
当Package Control卡死或公司网禁访问packagecontrol.io时，手动装是唯一出路，但90%失败源于路径和解压方式错误。
- 下载ZIP包后，**不要双击打开再复制内容**——要右键“全部解压到当前文件夹”，得到一个同名文件夹（如
SideBarEnhancements/），再把这个文件夹整体拖进Packages/ -
.sublime-package结尾的文件（如BracketHighlighter.sublime-package）**不能解压**，直接扔进Installed Packages/，重启即生效 - 别信“重启一次就行”：改了
Installed Packages/或Packages/后，必须彻底退出Sublime（任务管理器里杀进程），再重新打开
真正麻烦的从来不是装不上，而是装上了却以为没装上，反复重装覆盖残留文件。盯住Package Control: List Packages是否返回列表，比盯着菜单多一个选项重要得多。
