package control未加载导致install package命令不出现,需先执行sublime.version()确认st4版本,删净installed packages/中旧文件,运行带sha256校验的官网脚本并彻底退出重启;列表为空则因channel失效,须改用gitee镜像v3地址;插件无效多因ignored_packages屏蔽或路径放错。

Package Control 没装上,就别谈插件了——它不加载,Package Control: Install Package 命令根本不会出现在命令面板里。
Package Control 命令完全不出现?先确认它是否真在运行时里
按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Package Control。如果一行结果都没有,说明 Package Control 连初始化都没完成,不是插件的问题,是包管理器本身缺席。
- 打开控制台(
Ctrl+`),执行sublime.version():返回4xxx表示 ST4,必须用带hashlib.sha256校验的最新脚本;返回3xxx也建议升级到 ST4,旧版 TLS 兼容性差,容易静默失败 - 进
Installed Packages/目录,删掉所有含Package Control字样的文件(包括残留的Package Control.sublime-package) - 粘贴并执行官网最新手动安装代码(ST4 专用):
import urllib.request,os,hashlib; h='6f4c264a24d237259395a6f7a7eb1a8e'+'6c5b3b5e'; pf='Package Control.sublime-package'; ipp=sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by=urllib.request.urlopen('https://packagecontrol.io/'+pf.replace(' ','%20')).read(); dh=hashlib.sha256(by).hexdigest();print('Error validating download: %s'%dh if dh!=h else 'Success'); open(os.path.join(ipp,pf),'wb').write(by) - 看到
Success才算落盘成功;若报URLError或超时,别重试,直接切到换源步骤 - 执行完必须彻底退出 Sublime(右键任务栏选「退出」,不是关窗口),再重启验证
装上了但 “There are no packages available”?本质是 channels 地址不可访问
这个报错和插件无关,只说明 Package Control 请求的插件列表 JSON 返回空或 404。国内用户几乎全卡在这步,浏览器里打不开 channels 地址,Sublime 就永远等不到数据。
- 打开
Preferences → Package Settings → Package Control → Settings – User - 填入可用的 v3 镜像地址(2026 年实测有效):
"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"] - 把这个 URL 粘到浏览器地址栏回车——必须能直接加载出完整 JSON,否则无效;打不开就换网络、关杀毒软件(火绒/360 常静默拦截
urllib请求) - 别用博客里抄的旧链接,比如 php.cn 的 channel 地址已在 2026 年全部失效
- 如果提示
schema_version mismatch,说明用了 v2 channel 匹配新版 Package Control,必须统一用channel_v3.json
插件手动放对了目录却没反应?90% 是被 ignored_packages 屏蔽了
Sublime 不会报错,也不会警告,只要插件名出现在 ignored_packages 列表里,它就直接跳过加载——这是最隐蔽的“静默失效”原因。
- 打开
Preferences → Settings,看右侧用户配置中是否有"ignored_packages"字段 - 检查你刚安装的插件名(如
"Emmet"、"ChineseLocalization")是否在该数组里 - 删掉对应项,或整行注释(加
//前缀),保存后必须重启才生效 - 不确定插件名?GitHub 下载 ZIP 解压后常多一层
plugin-name-master,这层是 GitHub 包装壳,真正插件名是里面那个含__init__.py的子文件夹名,例如把BracketHighlighter-master/BracketHighlighter/提出来重命名为BracketHighlighter - 文件夹名不能含中文、空格、点号(
.)或特殊符号,否则 Sublime 可能跳过加载
路径放错是手动安装失败的第一原因,两个目录分工严格
.sublime-package 文件和解压后的文件夹,绝对不能混放。Sublime 对这两个目录有硬性分工,放错就等于没装。
-
.sublime-package文件(如EmmyLua.sublime-package)→ 必须直接丢进Installed Packages/,不要解压、不要改名、不要嵌套子目录 - GitHub 下载 ZIP 解压后得到的文件夹(如
Emmet/)→ 必须整体复制进Packages/根目录,不能放进Packages/User/或Packages/Default/ - 用
Preferences → Browse Packages…打开的就是Packages/;它的上一级目录里的Installed Packages/才是另一个位置 - 不确定真实路径?在控制台运行:
print(sublime.packages_path())和print(sublime.installed_packages_path()) - 某些插件(如
Origami)还需在命令面板里手动执行一次初始化命令,不是放进去就自动弹窗
最容易被忽略的是:Windows/macOS 下 Sublime 常驻后台进程,只关窗口不算真正退出;ignored_packages 修改后不重启 = 白改;以及浏览器里打不开的 channels 地址,在 Sublime 里一定也拉不到数据——这些点不踩准,其他操作全是白忙活。











