package control 打不开的根本原因是未安装或加载失败,需先确认其本体是否就位、路径是否正确、配置是否被屏蔽;命令面板无提示说明未加载,须按版本重装或清理残留。

Package Control 打不开,不是插件服务器“挂了”,而是你根本没装上或它加载失败——官网打不开只是表象,真正卡点在 Package Control 本体是否就位、路径是否放对、配置是否被静默屏蔽。
Package Control 命令面板里压根不出现
这说明 Sublime Text 连包管理器都没加载,所有“插件装不上”的问题都得先过这一关。
- 按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Package Control,什么提示都没有 → 就是没装 - 打开控制台(
Ctrl+<code>或Cmd+),运行sublime.version():- 返回
4xxx:必须用带hashlib.sha256校验的 ST4 专用安装脚本(官网最新那一行) - 返回
3xxx:确认是否低于 Build 3176,旧版 TLS 不兼容,建议升级
- 返回
- 如果控制台报
ImportError: No module named 'package_control',或执行完脚本后仍无命令 → 删干净Installed Packages/下所有含Package Control的文件,再重装 - 离线安装时,
Package Control.sublime-package文件必须放进Installed Packages/目录,不是Packages/;放错位置等于没装
Package Control: Install Package 能点开但空白或一直“Loading…”
这是 Package Control 已加载,但拉不到插件列表——99% 是 channels 配置失效或网络拦截。
- 打开
Preferences → Package Settings → Package Control → Settings – User - 检查
"channels"字段:空数组、旧地址(如v2.json)、Gist 链接已删 → 全部无效 - 替换为当前可用的 v3 镜像,例如:
{"channels": ["https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"]} - 把这个 URL 粘到浏览器里直接打开,能看见 JSON 内容才算通;打不开就换热点或关火绒/360(它们常静默拦截 Sublime 的 Python 请求)
- 如果控制台报
schema_version mismatch,说明用了 v2 channel 匹配 ST4 → 必须统一用channel_v3.json
插件文件放对了却完全没反应
文件路径、命名、忽略列表三者错一个,插件就等于不存在。
-
.sublime-package文件(如Emmet.sublime-package)→ 放进Installed Packages/,不解压 - GitHub 下载的 ZIP → 解压后得到
Emmet/文件夹 → 整个文件夹复制进Packages/根目录(不是子目录,不能叫Emmet-master/) - 打开
Preferences → Settings,检查右侧用户配置里的"ignored_packages":- 如果刚放的插件名(如
"EmmyLua")在里面,它就被静默禁用 - 删掉该项,或整行注释,保存后必须完全退出 Sublime 再重启
- 如果刚放的插件名(如
- 插件文件夹名大小写必须和官方一致(
PyV8≠pyv8),Sublime 区分大小写
PyV8 报错、老插件无法初始化、更新后功能异常
这不是网络问题,是依赖链断裂或缓存残留。
-
PyV8类错误(如ImportError: No module named 'PyV8'):ST4 已移除支持,ST3 用户需手动补二进制- 去 Gitee 镜像站下载对应系统 + Python 版本的包(如
pyv8-win64-p3.zip) - 解压后所有内容塞进
Packages/PyV8/(文件夹名必须是PyV8,首字母大写)
- 去 Gitee 镜像站下载对应系统 + Python 版本的包(如
- 手动更新插件:不能覆盖,必须先删旧再放新
- 关闭 Sublime,进
Packages/或Installed Packages/,删掉旧插件文件或文件夹 - 放入新版,确保文件夹名 / 文件名完全一致(包括大小写)
- 关闭 Sublime,进
- 某些插件(如
Origami)需首次手动运行初始化命令,不是放进去就自动生效
离线安装最脆弱的环节不在下载,而在路径、命名、忽略列表这三处——它们不报错,只静默失效。每次重启前,务必确认 sublime.installed_packages_path() 和 sublime.packages_path() 输出的路径是否和你放文件的位置一致。











