离线安装sublime插件必须满足三要素:放对路径(package control进installed packages,github插件进packages根目录)、用对名称(去-master/-dev、大小写精准)、彻底重启;缺一不可。

离线安装 Sublime 插件,不是“拖进去就完事”,而是必须把文件放到 Sublime 真正会扫描的位置、用它认的名字、再彻底重启——三者缺一不可。装不上基本都卡在这三个环节,和插件本身无关。
Package Control 必须放 Installed Packages 目录
Package Control 是离线装其他插件的前提,但它不能像普通插件那样扔进 Packages/。ST4 会忽略放在那里的 Package Control.sublime-package 文件。
- 先关闭所有 Sublime Text 进程(macOS 用 Activity Monitor 杀掉
subl,Windows 在任务管理器结束全部subl.exe) - 运行
sublime.version()确认是 4xxx 版本 - 打开菜单 Preferences → Browse Packages…,在文件管理器中上退一级,进入
Installed Packages/目录 - 删掉里面所有含
Package Control字样的文件(包括残留的文件夹) - 放入官方镜像下载的
Package Control.sublime-package(大小必须为 180–220 KB;小于 100 KB 就是下载损坏) - 不解压、不改名、不嵌套子目录
重启后按 Ctrl+Shift+P 输入 Package Control: List Packages,能列出结果才算真正加载成功。
GitHub 下载的 ZIP 插件要重命名后放 Packages 根目录
从 GitHub 点 Download ZIP 得到的压缩包,解压后默认是 Emmet-master/ 或 ConvertToUTF8-main/ 这类带后缀的文件夹——Sublime 不识别这层包装壳,会直接跳过。
- 进入该文件夹,找到真正含
__init__.py或主模块(如git_gutter.py)的子目录 - 把它单独拎出来,重命名为插件官方名:
Emmet-master/→Emmet/,VueSyntaxHighlight-dev/→VueSyntaxHighlight/ - 大小写必须完全一致,不能多空格、不能加下划线、不能留
-main或-dev - 整个重命名后的文件夹,直接拖进
Packages/根目录(不是Packages/User/,也不是Installed Packages/)
检查文件夹内至少有一个 .py 文件,且其中定义了继承自 sublime_plugin.TextCommand 或 sublime_plugin.EventListener 的类。
插件放对了但命令搜不到?先查 ignored_packages 和语法作用域
命令面板搜不到、快捷键无效、菜单不出现,大概率不是没装上,而是被 Sublime 主动跳过了。
- 打开 Preferences → Settings,检查右侧用户设置里是否有
"ignored_packages"字段;如果刚装的插件名(比如"Emmet")正好在里面,它就被静默禁用 - 很多插件只在特定语法下生效:例如
VueSyntaxHighlight只响应.vue文件或text.html.vue作用域,开纯.html文件时右下角显示HTML,它就完全沉默 - 按
Ctrl+Shift+P输入Set Syntax:手动切换语法再试命令;或临时注释掉ignored_packages验证
路径和命名大小写敏感——Windows 上看着一样也不行,emmet/ 和 Emmet/ 是两个东西。
汉化插件 ChineseLocalization 必须手动设 locale 才生效
装完 ChineseLocalization.sublime-package 并不等于中文界面自动出现。它是个“翻译引擎”,需要明确告诉它用哪种语言。
- 把
ChineseLocalization.sublime-package文件拖入Installed Packages/(不是Packages/) - 彻底退出 Sublime Text,再重开
- 打开 Preferences → Settings,在右侧用户设置里添加一行:
"locale": "zh_CN" - 保存后必须完全退出再重开(仅关窗口或
Cmd+Q可能残留后台进程) - 不能写成
zh-cn(小写)、zh_CN.UTF-8(多余后缀)或zh-Simplified(ST4 已弃用)
验证方式:按 Cmd+Shift+P 输入 Set Locale,看是否有中文选项;或观察菜单栏 “Preferences” 是否变成 “首选项”。











