package control未安装导致插件无法启动，需先验证sublime版本、手动执行官方安装脚本、换用gitee镜像源、检查ignored_packages列表并确保路径与命名规范。
Package Control 没装上，插件安装就根本不会启动——不是你操作错了，而是 Sublime 连包管理器都没加载进来。
Package Control 命令压根不出现？先确认它是否真在运行时里
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS），输入 Package Control。如果一行结果都没有，说明它没进 Sublime 的 Python 运行环境。
- 打开控制台（
Ctrl+`），执行sublime.version()：返回4xxx是 ST4，必须用带hashlib.sha256校验的官方脚本；返回3xxx建议升级，旧版 TLS 兼容性差，容易静默失败 - 删净
Installed Packages/目录下所有含Package Control字样的文件（包括残留的Package Control.sublime-package） - 粘贴并执行 ST4 官方手动安装代码（注意：别从博客复制，容易混入不可见 Unicode 字符）
- 看到
Success或写入路径日志才算落盘成功；若报URLError或超时，别重试，直接切到换源步骤 - 执行完必须彻底退出 Sublime（右键任务栏选「退出」，不是关窗口），再重启验证
装上了但 “There are no packages available”？本质是 channel 地址打不开
这个提示和插件无关，只说明 Package Control 请求的 channel_v3.json 返回空或 404。国内用户几乎全卡在这步。
- 打开
Preferences → Package Settings → Package Control → Settings – User - 确保
"channels"字段只有一条有效镜像，推荐用 Gitee 源："https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" - 把该 URL 粘到浏览器地址栏敲回车：能加载出完整 JSON（开头是
{ "packages": [）才算真正有效；如果 404、空白页、证书错误或转到 Gitee 登录页，立刻换源 - 常见失效原因：抄了旧博客里的 php.cn 链接（2026 年全 404）、用了
raw.githubusercontent.com直链（被墙）、漏了/raw/master/路径段 - Gitee 镜像必须带
/raw/master/，否则返回 HTML 页面而非 JSON
插件放对了却没反应？大概率被 ignored_packages 静默屏蔽
这是最隐蔽的“静默失效”原因：插件明明在 Packages/ 里，命令面板搜不到、快捷键没反应，大概率被 Sublime 主动忽略了。
- 打开
Preferences → Settings，看右侧用户配置中是否有"ignored_packages"字段 - 如果刚装的插件名（如
"Emmet"、"ChineseLocalization"）出现在这个列表里，它就被禁用了 - 删掉对应项，或临时整行加
//注释掉，保存后重启验证 - 别凭感觉拖拽：用菜单
Preferences → Browse Packages…打开的路径就是Packages/；它的上一级目录里那个叫Installed Packages/的才是另一个地方 - 不确定？在控制台运行：
print(sublime.packages_path())和print(sublime.installed_packages_path())看真实路径
手动解压安装失败？路径、命名、层级三处错一点就彻底不加载
Sublime 对目录结构和文件名极其敏感，放错一层就彻底不加载。
-
.sublime-package文件（如Emmet.sublime-package）必须扔进Installed Packages/目录 - 从 GitHub 下载的 ZIP 解压后得到的是文件夹（比如
Emmet-master/），就得整个放进Packages/根目录 - GitHub ZIP 解压后多了一层目录？点
Code → Download ZIP得到的压缩包，解压后几乎总会多出一层plugin-name-main或plugin-name-master——这层是 GitHub 自动生成的“壳”，Sublime 不认它 - 进到那层目录里，找到真正含
__init__.py或主.py文件的子文件夹，把它单独拎出来，重命名为干净名称（如把BracketHighlighter-master改成BracketHighlighter） - 确保名字不含空格、中文、点号（
.）或特殊符号；大小写必须和插件官方名完全一致
ssl.CertificateError）、channels URL 是否能在浏览器直连、ignored_packages 里有没有刚装的插件名。其余全是干扰项。
