package control: install package命令不出现，说明其根本未加载成功；唯一可靠判断标准是命令面板中能调出package control: list packages且install package出现在补全列表中，常见原因包括st4误用st3脚本、文件放错目录、系统拦截写入或未重启编辑器。
Package Control: Install Package命令不出现或报command not found
这不是插件没装好，而是Package Control根本没加载成功——菜单里有Package Settings → Package Control只是旧版残留，不可信。真正有效的判断标准只有两个：Ctrl+Shift+P输入Package Control: List Packages能执行，且Package Control: Install Package出现在补全列表中。
常见原因和对应操作：
- 控制台执行脚本后只显示
reloading plugin或完全无输出：大概率是 TLS 握手失败或 DNS 超时，等满 5 秒再判断；若左下角没弹出Package Control: Successfully installed Package Control，就当没成功 - ST4 用户误用了 ST3 脚本（比如哈希以
bf11abc3开头）：脚本静默运行但后续所有命令都失效，必须清空Installed Packages/里所有含Package Control字样的文件，重装 ST4 专用脚本 - 手动安装时把
Package Control.sublime-package拖进了Packages/目录而非Installed Packages/：Sublime 不会扫描该路径，必须关掉编辑器，挪到正确目录再重启 - macOS 报
Operation not permitted或 Windows 返回空的sublime.installed_packages_path()：说明系统策略拦截了写入，此时只能手动安装，并先在控制台执行sublime.installed_packages_path()确认真实路径
Install Package命令能调出但搜不到任何插件
不是网络断了，也不是插件源失效，而是Package Control首次运行时默认不主动拉取 channel 列表，这个过程无声无息、不提示、不报错，只在你第一次执行Install Package时才触发。
表现是：回车后光标变空转圈，状态栏长时间显示Fetching list of available packages或干脆没反应。
- 等满 10 秒再判断，国内网络环境下首次同步通常需要 5–12 秒，别急着关面板
- 如果卡住超过 15 秒，直接执行
Package Control: Synchronize Packages，比重启 Sublime 更有效 - 检查
Preferences → Package Settings → Package Control → Settings – User里"channels"是否为默认值："https://packagecontrol.io/channel_v3.json"，被改过就会导致索引拉不下来 - 某些代理配置错误（比如
"https_proxy"指向已关闭的端口）会导致后台线程挂起，可临时删掉该字段再试
执行Install Package后列表为空或搜不到Emmet/ColorPicker等常用插件
插件名大小写敏感，且必须匹配仓库元数据中的 exact name，不是你印象里的名字。
- 输
emmet搜不到，但输Emmet就能命中——因为插件注册名是Emmet，不是小写 -
Vue Syntax Highlight不能输成vue-syntax-highlight或vue highlight，得按 GitHub 仓库名原样输入 - 右下角状态栏看当前语法（如
Plain Text），有些插件只在特定语法下激活，比如Vue Syntax Highlight只对.vue文件生效 - 检查用户设置里是否有
"ignored_packages"字段，误加了插件名（如"Emmet"）会导致它被强制禁用
手动安装Package Control时文件放错位置或改名失败
这是最常被忽略的细节：文件名、路径、解压状态三者必须同时正确，错一个就静默失败。
- 下载地址必须是
https://packagecontrol.io/Package%20Control.sublime-package（注意空格是%20，不是 - 文件名必须严格为
Package Control.sublime-package，不能加数字、下划线，不能改成package_control.sublime-package - 必须拖进
Installed Packages/目录，不是Packages/，也不是Packages/User/ - 绝对不要解压，.sublime-package 是 ZIP 格式但 Sublime 要求原样加载，解压后反而无法识别
- 扔进去之后必须重启 Sublime Text，否则插件加载器不会扫描该目录
List Packages并返回空列表，才是唯一可信的起点。其余所有界面变化，都是干扰项。
