package control未加载导致插件无法安装，需先通过控制台确认st版本、清理残留文件、执行官方st4脚本并彻底重启；若命令面板无响应，则检查channels地址有效性、ignored_packages设置及插件路径是否正确。
Package Control 命令面板里根本找不到？先别装插件
Package Control 没加载，所有插件安装都是空谈。按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control，如果一行结果都没有，说明它压根没进 Sublime 的运行时环境。
打开控制台（Ctrl+`），执行 sublime.version()：返回 4xxx 是 ST4，必须用带 hashlib.sha256 校验的安装脚本；返回 3xxx 建议升级——旧版 TLS 兼容性差，容易静默失败。
- 删净
Installed Packages/目录下所有含Package Control字样的文件（包括残留的Package Control.sublime-package） - 粘贴并执行官网最新 ST4 脚本（哈希值以
6f4c264a开头），看到Success才算落盘成功 - 必须彻底退出 Sublime（右键任务栏选「退出」，不是关窗口），再重启验证
“There are no packages available” 列表为空？不是插件问题
这个提示本质是 Package Control 请求的 channels 地址返回了空 JSON 或 404，和插件本身无关。国内用户几乎全卡在这步。
打开 Preferences → Package Settings → Package Control → Settings – User，确认 "channels" 至少有一条可用地址，例如："https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"。
- 把该 URL 粘到浏览器里直接访问，能加载出完整 JSON 才算有效；打不开就换网络、关杀毒软件（火绒/360 常静默拦截
urllib请求） - 别用博客里抄的旧链接，比如某些 php.cn 的地址在 2026 年已全部 404
- 控制台报
schema_version mismatch？说明用了 v2 channel 匹配新版 Package Control，必须统一用channel_v3.json
插件装上了但命令面板找不到、快捷键无效？它被你“忽略”了
不是没装成，是被 Sublime 主动屏蔽了。常见于路径放错、ignored_packages 设置、或依赖缺失。
检查 Preferences → Settings – User 中是否有 "ignored_packages": ["Terminus"] 这类配置，刚装的插件名在里面就会被静默屏蔽。
-
.sublime-package文件必须放进Installed Packages/目录；解压后的文件夹必须整体放进Packages/（不能嵌套子目录） - 路径名必须与插件原始仓库名完全一致（例如
Terminus，不能是terminus或带空格） - 依赖报错如
ImportError: No module named 'mdpopups'，说明插件需要的底层模块没装对——Sublime 不会自动装依赖，得手动装或换兼容版本
手动安装插件时丢错目录？Sublime 会直接无视
Sublime 只从特定目录读取插件，丢错位置等于没装。关键不是“怎么复制”，而是“复制到哪”。
通过菜单 Preferences → Browse Packages… 打开的是用户 Packages 目录（不是 Installed Packages 或缓存目录）。Windows、macOS、Linux 的绝对路径不同，但都指向这个位置。
- 不要放进
Installed Packages/——那是 Sublime 自动管理的压缩包存放地，手动丢进去不会生效 - 不要放进
Packages/Default/或Packages/User/子目录里，它们有特定用途 - 举例：手动装
Terminus.sublime-package，就直接扔进Packages/根目录；如果是解压后的Terminus/文件夹，也扔进同一级，确保路径是Packages/Terminus/xxx.py
最常被忽略的是：插件生效依赖语法作用域、配置路径和加载顺序。比如 Terminus 的快捷键只在终端面板激活时响应，而 Set Syntax: Plain Text 下的文件根本不会触发任何语法高亮插件——这些细节不看文档，光靠“装上就用”永远踩坑。
