Package Control安装失败时优先离线安装:下载Package Control.sublime-package文件放入Installed Packages目录并重启,再按Ctrl+Shift+P搜索Install Package验证;若搜索无响应需等待10–15秒或配置代理修复channel加载。

Package Control 安装失败时,别硬等控制台输出
直接粘贴 Python 安装代码后没反应,或提示 urllib.error.URLError、ssl.SSLCertVerificationError,大概率是网络或证书问题。Sublime Text 3 内置的 Python 2.7/3.3 环境对现代 HTTPS 有兼容限制,尤其在 2026 年多数源站已停用旧协议。
实操建议:
- 优先改用离线安装:从
https://packagecontrol.io/Package%20Control.sublime-package下载Package Control.sublime-package文件(注意 URL 中空格已编码) - 手动放入
Installed Packages目录——Windows 是%APPDATA%\Sublime Text 3\Installed Packages,macOS 是~/Library/Application Support/Sublime Text 3/Installed Packages - 重启 Sublime 后,按
Ctrl+Shift+P能搜到Package Control: Install Package就算成功,不用等控制台弹 README
Install Package 搜索不到插件?先确认索引是否加载完成
输入 Install Package 后空白或只显示几个默认项,不是插件下架了,而是 Package Control 的远程仓库列表还没拉下来。这个过程依赖网络,且首次运行可能卡住几秒到几十秒,期间搜索框无反馈是正常现象。
实操建议:
- 耐心等待 10–15 秒再输插件名,不要反复按回车或关闭重开命令面板
- 想确认状态:打开控制台(
Ctrl+`),看到类似generating syntax summary或loading repository日志才算启动中 - 如果一直卡在
downloading channel...,说明被拦截,可临时配代理(Preferences → Package Settings → Package Control → Settings),加一行:"http_proxy": "http://127.0.0.1:8080"
手动安装插件时,Packages 和 Installed Packages 别搞混
把 .sublime-package 文件扔进 Packages 目录不会生效,反之把解压后的文件夹放进 Installed Packages 会直接报错。这两个目录用途严格分离:
-
Packages:只放**源码级插件文件夹**(比如从 GitHub clone 下来的Emmet目录,里面含.py和.json) -
Installed Packages:只放**二进制分发包**(即后缀为.sublime-package的 ZIP 文件) - 路径不对会导致插件不显示、不响应快捷键,甚至引发
reloading plugin循环日志
插件装完没反应?检查是否需要额外配置或重启
像 ChineseLocalization、SideBarEnhancements 这类插件,安装后界面没变化是正常的——它们不自动激活,得手动触发或设为默认行为。
实操建议:
- 查文档:安装后立刻看插件主页的
Usage或Key Bindings小节,比如SideBarEnhancements需右键侧边栏才出现菜单 - 部分插件要求重启 Sublime(尤其是改了 UI 或底层 API 的),不是“重新加载”就能生效
- 若插件带设置文件(如
Preferences → Package Settings → XXX → Settings – User),空配置常导致功能静默失效,至少补个{}再保存
Preferences → Package Settings → Package Control → Settings – User 确认 "bootstrapped" 是否为 true,再手动执行一次 Package Control: Upgrade Package。

















