package control 必须先安装,否则所有插件操作无效;安装需通过命令面板执行 install package control,重启后验证存在;卸载插件需手动清理配置、快捷键及缓存;lsp 类插件须清 cache;重装前须执行 subl --sync-logout 防止云端同步恢复插件。

Package Control 必须先装,否则所有插件操作都无效
Sublime Text 默认不带插件管理能力,Package Control 是唯一靠谱的插件中枢。没它,手动放文件到 Packages/ 目录容易路径错、权限锁、依赖漏,装完也不显示在 Preferences → Package Settings 里。
装法只有一种推荐路径:按 Ctrl+Shift+P(Windows/Linux)或 Cmd+Shift+P(macOS),输入 Install Package Control 回车。等左下角“=”停止晃动、弹出成功提示,重启 Sublime 即可。
- 别复制粘贴旧版 Python 安装脚本——Sublime Text 4 已弃用
urllib.request方式,会报ModuleNotFoundError: No module named 'urllib2' - 装完立刻验证:
Preferences → Package Settings里要有Package Control项,且能点开 - 如果命令面板搜不到
Install Package Control,说明你用的是极老版本(如 ST2),建议升级到 ST4
卸载插件不能只靠 Package Control: Remove Package
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 类插件卸载后 CPU 还飙高?清 Cache 是硬要求
像 pyright、texlab、LSP-pyright 这类语言服务器插件,卸载后仍在 Cache/ 目录存着 socket、索引和编译产物,Sublime 启动时自动拉起它们,导致卡顿、命令面板搜得到但执行报错。
- Windows:删
%LOCALAPPDATA%\Sublime Text\Cache\下所有含pyright、lsp、texlab的子目录(或直接清空整个Cache) - macOS:删
~/Library/Caches/com.sublimetext.4/和~/Library/Saved Application State/com.sublimetext.4/(后者会偷偷恢复插件状态) - Linux:运行
rm -rf ~/.cache/sublime-text/*
重装前不登出同步账号,插件会自动复活
Sublime Text 4 默认开启云端同步。只要之前执行过 subl --sync-login,哪怕你手动删光 Packages/、Cache/、Local/,首次启动时它会从服务器把旧插件列表拉回来,重新下载安装。
彻底清理前务必先执行:subl --sync-logout(终端运行),再删本地文件。否则你删半天,一打开编辑器,GitGutter 和 SideBarEnhancements 又安静地躺在 Packages/ 里了。











