package control必须先安装,否则所有插件操作均无效;它是sublime text唯一被官方和社区长期验证的包管理框架,st4用户须用官网installation.py脚本或手动拖入package control.sublime-package至installed packages/目录,并通过ctrl+shift+p执行list packages和install package验证生效。

Package Control 必须先装,否则所有插件操作都无效
Sublime Text 默认不带插件管理能力,Package Control 是唯一被官方和社区长期验证的插件中枢。没它,手动把 ZIP 解压进 Packages/ 目录会出路径错、权限锁、依赖漏——装完也看不到 Preferences → Package Settings 里的配置项。
装法只有一种推荐路径:Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Install Package Control 回车。等左下角 “=” 停止晃动、弹出成功提示,重启 Sublime 即可。
- 别复制粘贴旧版 Python 脚本——ST4 已弃用
urllib2,会报ModuleNotFoundError: No module named 'urllib2' - 如果命令面板搜不到
Install Package Control,说明你用的是 ST2 或更老版本,建议直接升级到 ST4 - 菜单里有
Package Control选项 ≠ 它能联网、能调出插件列表、能执行Install Package命令
ST4 用户必须用官网 installation.py 脚本或手动拖包
2026 年绝大多数用户用的是 Sublime Text 4,装错版本脚本会导致命令面板里搜不到 Install Package,且控制台不报错、静默失效。必须亲眼确认版本:打开 Help → About Sublime Text,看顶部显示的是 Sublime Text 4 还是 Sublime Text 3。
方法一:控制台一键执行(需网络通畅)
按 Ctrl+` 呼出控制台 → 严格复制以下整段代码,一次性粘贴并回车: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 才算真成功。若只显示 reloading plugin 或无反应,大概率是网络超时或证书拦截,别重试,直接切手动方式。
方法二:手动安装(绕过网络/代理/SSL限制)
① 关闭 Sublime Text
② Preferences → Browse Packages… → 关闭窗口,向上退一级进入 Installed Packages/ 目录
③ 访问 https://packagecontrol.io/Package%20Control.sublime-package,下载该文件
④ 将下载好的 Package Control.sublime-package 文件直接拖入 Installed Packages/ 目录(【不要解压,不要改名,不要放进 Packages/ 目录】)
⑤ 重启 Sublime Text
⚠️ 如果之前装过旧版,先清空 Installed Packages/ 里所有含 Package Control 字样的文件,否则残留会劫持命令通道。
验证 Package Control 是否真正生效
别信菜单里有没有选项,只认两个硬指标:
按 Ctrl+Shift+P → 输入 Package Control: List Packages → 能执行并返回结果;
再输入 Package Control: Install Package → 能弹出插件搜索框并加载列表。
-
Preferences → Package Settings里要有Package Control项,且能点开 - 如果
List Packages报错或卡住,说明安装未完成,不是网络问题就是残留干扰 - 某些企业内网或 macOS 系统级防火墙会拦截
https://packagecontrol.io,此时只能走手动安装
插件装完就崩?卸载不干净是常见原因
Package Control: Remove Package 只删 Installed Packages/xxx.sublime-package 和 Packages/xxx/ 文件夹,但插件留下的配置、快捷键、缓存全都在那儿,下次启动可能仍触发崩溃或命令未定义错误。
删完插件后,立刻做三件事:
① 进 Packages/User/,删掉同名 .sublime-settings 文件(比如卸载 GitGutter 就删 GitGutter.sublime-settings)
② 打开 Packages/User/Default (Windows).sublime-keymap(或对应系统文件),全局搜索插件命令名(如 "command": "git_gutter"),整块删掉
③ 关死所有 Sublime 进程再删文件:
• Windows:任务管理器结束 sublime_text.exe 和 subl.exe
• macOS:「活动监视器」强制退出全部 Sublime Text
• Linux:执行 pkill -f "sublime_text"
LSP 类插件(如 pyright、texlab、LSP-pyright)卸载后 CPU 还飙高?清 Cache/ 是硬要求:
Windows:删 %LOCALAPPDATA%\Sublime Text\Cache\ 下所有含 pyright、lsp、texlab 的子目录(或直接清空整个 Cache)
macOS:删 ~/Library/Caches/com.sublimetext.4/ 和 ~/Library/Saved Application State/com.sublimetext.4/(后者会偷偷恢复插件状态)











