sublime text插件问题90%源于安装流程陷阱:package control未真加载、channel地址失效(需换gitee镜像并浏览器验证)、路径放错(.sublime-package进installed packages/,解压文件夹进packages/根目录)、ignored_packages屏蔽或卸载不彻底(需清配置、快捷键及缓存)。

Sublime Text 插件装不上、装完不生效、卸载后还报错——这些问题 90% 都不是插件本身的问题,而是安装流程里踩了几个隐蔽但致命的坑。
Package Control 没真正加载,就别碰 Install Package
命令面板里能搜到 Package Control: Install Package ≠ 它能跑通。常见假成功现象:输入回车后左下角没出现 Fetching list of available packages,控制台静默,甚至命令面板直接关闭。
- 真正通路的标志只有两个:
Package Control: List Packages返回空列表(不是报错),Package Control: Install Package触发网络请求日志 - ST4 用户若用了 ST3 的旧安装脚本(sha256 哈希值不是以
6f4c264a开头),控制台可能显示Success!,但后续所有 Package Control 命令都无效 - 国内用户常卡在 DNS 污染,
http://packagecontrol.io/解析失败 → 必须手动换 channel 地址,例如:"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json",且要浏览器里直接打开验证 JSON 可加载
插件“装上了”不等于“能用”,语法作用域和路径必须对得上
比如装了 Vue Syntax Highlight,但打开 .html 文件没高亮,不是插件坏了,是它压根没被触发。
- 右下角状态栏看当前语法是否为
Vue或作用域匹配text.html.vue;纯.html文件默认走 HTML 语法,不会加载 Vue 插件 - 手动切换语法验证:
Ctrl+Shift+P→ 输入Set Syntax: Vue,立刻看高亮是否生效 - 路径放错是高频问题:
Emmet.sublime-package必须扔进Installed Packages/;而解压后的Emmet/文件夹必须整体拖进Packages/(不能嵌套进子目录,也不能漏掉Emmet/外层文件夹)
卸载插件只点 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"这类字符串,整块删掉 - LSP 类插件(如
pyright、LSP-pyright)卸载后 CPU 还飙高?必须手动清Cache/目录下的 socket 和索引文件,否则 Sublime 启动时仍会拉起残留进程
中文界面失效,大概率是 ignored_packages 里写了自己
装了 ChineseLocalization 却还是英文界面,最常见原因是配置里手误加了 "ignored_packages": ["ChineseLocalization"]。
- 检查
Preferences → Settings – User,确认ignored_packages数组里没把刚装的插件名写进去 - 汉化不自动生效:装完必须手动走
Help → Language → 简体中文,不是 Preferences 菜单里的任意位置 - 菜单正常但状态栏汉字变方块?说明字体没配对,在
Settings – User里加"font_face": "Microsoft YaHei"或"font_face": "SimSun"
这些坑大多藏在「看起来已经做完」的环节里,比如重启编辑器前没关死所有进程、换源后没验证 JSON 加载、卸载后没清 Cache —— 表面风平浪静,实际埋着下次打开就崩的雷。











