package control必须通过ctrl+`调出控制台执行官方脚本安装,而非菜单入口;失败主因是网络拦截或版本不匹配,成功标志为状态栏提示“successfully installed”且命令面板可执行list packages。

Package Control装不上?先确认控制台执行方式
Sublime Text 本身不带插件管理器,Package Control必须手动安装,否则所有插件都装不了。常见失败不是因为代码错,而是执行入口不对。
别用菜单里“Preferences → Package Control”——这个选项只有装完后才出现。必须用Ctrl+`(Tab 上方那个键)调出底部 Python 控制台,粘贴安装代码并回车。
- 如果快捷键被输入法拦截(比如 QQ 拼音),就去输入法设置里关掉“热键切换”
- 代码里域名已从
sublime.wbond.net切到packagecontrol.io,旧链接会超时或返回404 - ST4 用户必须用官网最新脚本,旧版 SHA1 校验或含
urllib2的代码会静默失效
装插件总卡在“Installing…”?检查网络和代理
按Ctrl+Shift+P输入Install Package后,弹窗空白、长时间转圈,基本是网络问题,不是插件源挂了。
Package Control默认走 HTTPS 请求https://packagecontrol.io,国内直连不稳定。它不支持设置代理,也不能配置镜像源;科学上网是唯一可靠解法。
- 若无法科学上网,可手动下载插件 ZIP 包,解压到
Preferences → Browse Packages对应目录(如ChineseLocalizations文件夹) - 插件名大小写敏感,比如
ConvertToUTF8写成converttoutf8就搜不到 - 安装后左下角短暂显示
Package Control installed,且Preferences → Package Settings下出现Package Control项才算成功
SideBarEnhancements 和 StatusBarEnhanced 装完没反应?配置漏了关键项
这两个插件装完不生效,90% 是因为没做后续配置,而不是安装失败。
SideBarEnhancements:右键菜单不出现在单个文件或空白处,只对侧边栏中通过Project → Add Folder to Project…添加的文件夹节点生效;还要检查Settings – User里有没有"ignored_packages": ["SideBarEnhancements"]。
StatusBarEnhanced:默认状态栏为空,必须手动编辑Preferences → Package Settings → StatusBarEnhanced → Settings,至少写一个"items"数组,例如:[{"type":"encoding","format":"ENC: {value}"}]。
-
"type"值必须合法(如"git_branch"、"line_endings"),拼错或大小写不对整条被忽略 -
"git_branch"不显示?先确认当前文件在 Git 仓库根目录下,子目录可能检测失败 - Windows 用户若开发目录在
C:\Program Files\等受控路径,新建文件会因权限静默拒绝
Build System 和 Key Bindings 别混在一起
F5 能不能运行 C++,跟插件无关,只取决于是否选对了编译系统。
必须手动通过Tools → Build System → C++17选中编译系统;Key Bindings里写的"variant":"Run"只是告诉 Build 系统执行哪个变体,不是启动插件。
- Build System 配置文件(如
C++17.sublime-build)要放在Packages/User/目录下,不能放错位置 - 快捷键绑定需加
context限定作用范围,否则可能全局生效、覆盖其他功能 - 改完
Key Bindings不用重启,但改Build System后要重新选一次编译系统才生效
真正卡住的点往往不在“怎么点”,而在版本匹配、路径权限、配置字段拼写和上下文触发条件——这些地方错一个字符,插件就等于没装。











