先确认package control装对了:st4必须用官方最新脚本(含urllib.request和https://packagecontrol.io/installation),st3混用会报错;装完重启后ctrl+shift+p输入package control应能显示命令列表,否则未生效。

插件安装失败?先确认 Package Control 装对了
Sublime Text 里装插件,90% 的问题出在 Package Control 没装好或装错版本。它不是内置功能,必须手动安装——而且不同 Sublime 版本(3 vs 4)对应不同的安装脚本,混用会导致 Package Control: Install Package 菜单项消失或点击无反应。
- Sublime Text 4 用户必须用官方最新脚本:打开
View → Show Console,粘贴并回车执行import urllib.request,os,sys; exec(urllib.request.urlopen('https://packagecontrol.io/installation').read().decode('utf-8')) - Sublime Text 3 用户不能直接套用 ST4 的脚本,否则控制台会报
AttributeError: module 'urllib' has no attribute 'request' - 装完后重启 Sublime,按
Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Package Control:能看到命令列表,才算真正就位
插件搜不到?检查网络和源配置
Package Control 默认走 https://packagecontrol.io/,国内直连常超时或返回空列表,表现为搜索框里一直转圈、无结果,甚至提示 No packages available。
- 临时解决:在命令面板中运行
Package Control: Add Repository,填入镜像地址如https://ghproxy.com/https://github.com/wbond/package_control_channel(注意是 channel 地址,不是 GitHub 仓库页) - 长期稳定:编辑
Preferences → Package Settings → Package Control → Settings,在channels数组里加一行镜像 URL,例如:"https://ghproxy.com/https://github.com/wbond/package_control_channel" - 别碰
http://开头的源——ST3/ST4 默认禁用不安全协议,强行添加会导致整个 Package Control 失效
装完插件没反应?看它是否需要手动启用或配置
很多插件(比如 EmmyLua、SublimeLinter、GitGutter)装完不会自动生效,得手动触发或补依赖,否则状态栏没图标、快捷键无效、右键菜单空空如也。
-
SublimeLinter必须单独装对应 linter(如eslint或pylint),且确保命令行能直接调用,否则只显示“linter not found” -
EmmyLua需要在Preferences → Package Settings → EmmyLua → Settings里填lua_path,指向你的 Lua 解释器路径,否则语法高亮和跳转全失效 -
GitGutter默认关闭,要进其设置文件把"enable": true改为true,不然 Git 状态差分始终不显示
插件冲突导致崩溃?优先禁用非核心插件排查
Sublime 启动卡死、频繁闪退、保存文件变慢,大概率是插件之间抢资源或监听同一事件(比如多个插件都 hook on_post_save_async)。这类问题不会报错,但日志里会有重复加载或 timeout 记录。
- 启动时加
-safe-mode参数(命令行运行subl -safe-mode),此时所有插件被禁用,如果正常了,说明问题出在插件层 - 逐个启用插件:禁用全部,再一个个开,每次重启观察行为变化;重点留意
Sync Settings、SideBarEnhancements、Alignment这类高频修改 UI 或文件系统的插件 - 某些插件(如旧版
BracketHighlighter)与 ST4 的新 API 不兼容,会拖慢整个编辑器响应,建议换用BracketHighlighter 3.0+或直接卸载
插件不是越多越好,真正影响体验的往往是那两三个没配好、没更新、或者根本没搞清自己要什么功能就装上的插件。











