package control装不上需先确认st4版本再执行官方脚本:打开help→about sublime text确认顶部显示“sublime text 4”,然后控制台执行官方python脚本或手动拖入package control.sublime-package至installed packages目录并重启,成功标志为ctrl+shift+p可运行list packages。

Package Control 装不上?先确认 ST4 版本再执行官方脚本
2026 年绝大多数人用的是 Sublime Text 4,装错脚本会导致 Ctrl+Shift+P 里搜不到 Install Package,且控制台不报错、静默失效。别凭印象操作,必须打开 Help → About Sublime Text 看顶部明确写着 “Sublime Text 4” 才算数。
装 Package Control 不是装插件,它是底层框架——没它,所有插件命令都调不出来。唯一可靠方式只有两个:
- 控制台执行(需网络通畅):
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')),粘贴后回车,等满 5 秒,左下角弹出Package Control: Successfully installed Package Control才算真成功 - 手动安装(绕过网络/SSL):关闭 ST →
Preferences → Browse Packages…→ 关闭窗口,向上退一级进Installed Packages/目录 → 下载https://packagecontrol.io/Package%20Control.sublime-package→ 拖入该目录(不改名、不解压、不放 Packages/)→ 重启
⚠️ 之前装过旧版?先清空 Installed Packages/ 里所有含 Package Control 字样的文件,否则残留会劫持命令通道。
插件卡在 “Installing…”?科学上网是唯一解法
Package Control 默认走 https://packagecontrol.io,国内直连极不稳定,且它不支持代理、不支持镜像源、不支持手动配置仓库地址。所谓“换源”“改 hosts”“本地缓存”全是无效动作。
常见现象包括:
- 按
Ctrl+Shift+P输入Package Control: Install Package后弹窗空白、转圈超过 10 秒 - 状态栏显示
Loading packages...但一直不动 - 控制台无错误输出,也无任何日志
此时别折腾配置,直接开科学上网工具。若完全无法科学上网,就放弃 Package Control 流程,改用手动安装:
- 去插件 GitHub/GitCode 页下载
.zip或克隆仓库 -
Preferences → Browse Packages…打开目录,把插件文件夹(如Emmet)整个拖进去 - 重启 ST,插件名大小写必须严格匹配,比如
ConvertToUTF8写成converttoutf8就不生效
短期项目只装这 3 个插件:Git、BracketHighlighter、AutoFileName
短期项目不追求功能堆砌,重点解决「协作」「可读性」「路径输入效率」三个刚需:
-
Git:提供Git: Status、Git: Commit、Git: Push等命令,按Ctrl+Shift+P输入Git即可调用,无需额外配置即可识别 Git 仓库根目录 -
BracketHighlighter:默认只高亮匹配括号,要看到竖线标识作用域范围,必须在插件设置里加一行:"content_highlight_bar": true;漏掉这行,看起来就像没装 -
AutoFileName:在引号内输入路径时自动补全文件名和文件夹,对前端项目引入 CSS/JS、Python 导入模块特别省事;它不依赖其他插件,开箱即用
别碰汉化类插件(如 ChineseLocalizations),ST4 原生已支持中文界面,装了反而可能冲突;也别装大而全的 LSP 插件,短期项目不需要实时类型检查和跳转。
装完不生效?检查是否误改 Build System 或 Key Bindings
很多人以为插件装完就该立刻可用,结果发现快捷键没反应、命令面板搜不到,其实是混淆了两个独立系统:
- 插件命令(如
Git: Commit)走的是Ctrl+Shift+P,和快捷键无关;你改了Key Bindings里的F5,不会影响Git插件本身 -
F5能不能运行 C++,取决于是否手动选中了Tools → Build System → C++17,不是靠插件自动绑定 - 如果某插件命令点了没反应,先打开控制台
Ctrl+`,看有没有ImportError或AttributeError—— 多半是插件依赖缺失或 Python 版本不兼容(ST4 内置 Python 3.8,部分老插件不支持)
短期项目最易被忽略的点:插件安装后不重启 ST,或重启后没清掉旧版本残留;更隐蔽的是,Installed Packages/ 和 Packages/ 两个目录混放导致加载冲突——前者只放 .sublime-package 文件,后者才放解压后的插件文件夹。











