离线装插件需确保文件放对位置且重启后控制台不报错:package control 必须置于 installed packages/ 目录,github 插件须重命名后放入 packages/ 根目录,注意大小写、禁用列表及语法作用域。

离线装插件,核心就一条:文件放对位置 + 重启后控制台不报错。别信“拖进去了就完事”,ST4 对路径、命名、类型极其敏感,错一个就静默失败。
Package Control 必须走 Installed Packages/ 目录直投
ST4 启动后按 Ctrl+Shift+P 搜不到 Package Control: Install Package,说明它根本没加载——哪怕控制台里出现 Package Control installed 提示,也可能是旧脚本静默失败。
- 先运行
sublime.version()确认返回值是4xxx - 关闭 Sublime Text,进
Installed Packages/目录,删掉所有含Package Control字样的文件(包括Package Control.sublime-package) - 去官方镜像下载完整包:https://www.php.cn/link/7574933a1b39d861a171370e4582ec28(注意 URL 中空格是 %20)
- 检查文件大小:必须在
180–220 KB;小于100 KB就是下载不全,丢弃重试 - 把下载好的
Package Control.sublime-package文件直接拖入Installed Packages/,不解压、不改名、不放进子文件夹
GitHub 下载的 ZIP 插件必须重命名后扔进 Packages/ 根目录
从 GitHub 点 Download ZIP 得到的压缩包,解压后默认是 Emmet-master/ 或 ConvertToUTF8-main/ 这类带后缀的文件夹——Sublime 不认。
- 打开
Preferences → Browse Packages…,这就是你要往里塞插件的Packages/目录 - 把解压后的文件夹重命名为插件官方名:
Emmet-master/→Emmet/,Origami-dev/→Origami/ - 大小写必须完全一致,不能多空格、不能加下划线、不能带
-master后缀 - 整个重命名后的文件夹直接拖进
Packages/根目录(不是子文件夹,也不是Installed Packages/)
插件放对了但命令搜不到?先查 ignored_packages 和语法作用域
常见假性“未安装”:文件在位、重启也做了,但命令面板无响应、快捷键无效——大概率被 Sublime 主动跳过了。
- 打开
Preferences → Settings,看右侧用户配置中是否有"ignored_packages"字段;如果刚装的插件名(比如"Emmet")正好在里面,它就被彻底禁用 - 插件常只在特定语法下触发:比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域,开纯.html文件时右下角显示HTML,它就完全沉默 - 按
Ctrl+Shift+P输入Set Syntax:手动切换语法,再试命令;或临时注释掉ignored_packages项验证
最易忽略的是路径和命名的大小写敏感性——Windows 上看着一样,但 ST4 内部按 Unix 规则比对;还有 .sublime-package 和解压文件夹绝对不能混放在同一个目录下,否则加载顺序冲突导致部分功能失效。











