sublime text离线装插件核心是文件放对位置并重启验证:.sublime-package文件必须放入installed packages/目录,解压后的插件文件夹须放入packages/根目录,路径、命名大小写敏感,且需检查ignored_packages和语法作用域。

Sublime Text离线装插件,核心就一条:文件放对位置 + 重启后验证控制台无报错。Package Control本身也得离线装,别信“控制台提示installed”就等于能用。
Package Control 离线安装必须走 Installed Packages/ 目录
ST4 启动后 Ctrl+Shift+P 搜不到 Package Control: Install Package,说明它根本没加载。控制台里出现 Package Control installed 提示不等于真装上了——旧脚本在 ST4 上会静默失败。
- 先运行
sublime.version()确认是 4xxx 版本 - 关闭 Sublime Text,进
Installed Packages/目录,删掉所有含Package Control字样的文件(包括Package Control.sublime-package) - 去 https://www.php.cn/link/2e5d5f65d3ef778b01366907d1f14445 下载(注意 URL 中空格是 %20),或用国内镜像 https://www.php.cn/link/becebedf1c232fd3fcd44dcd8c0ef821
- 文件大小应在 180–220 KB;小于 100 KB 说明下载不完整,丢弃重试
- 把下载好的
Package Control.sublime-package文件直接拖入Installed Packages/,不要解压、不要改名、不要放进子文件夹
.sublime-package 文件和解压文件夹不能混放
Sublime 对目录有硬性区分:.sublime-package 文件必须扔进 Installed Packages/;从 GitHub 下载 ZIP 解压出来的文件夹,必须整体放进 Packages/ 根目录。
- 用
Preferences → Browse Packages…打开的路径就是Packages/;它的上一级里的Installed Packages/才是另一个位置 - 文件夹名必须和插件官方名完全一致,大小写敏感 —— 比如
EmacsProMode,不能是emacspromode或EmacsProMode-master - 不确定路径?在控制台运行
print(sublime.installed_packages_path())和print(sublime.packages_path())查真实路径
插件放对了但不生效?先查 ignored_packages 和语法作用域
插件在 Packages/ 里,命令面板搜不到、快捷键没反应,大概率被 Sublime 主动忽略了。
- 打开
Preferences → Settings,看右侧用户配置中是否有"ignored_packages"字段;如果刚放进去的插件名(比如"Emmet")也在这个列表里,它就被静默禁用了 - 插件只在特定语法下触发 —— 比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域;打开纯.html文件时完全静默 - 右下角状态栏点开确认当前语法是否匹配;不匹配就按 Ctrl+Shift+P 输入
Set Syntax: Vue手动切换
PyV8 等带二进制依赖的插件要补全整个文件夹结构
Sublime Text 4 已彻底移除 PyV8,但某些老插件(如 Emmet、CSScomb)仍强依赖它。若必须用 ST3 兼容版:
- 去 Gitee 镜像站下载对应系统的包,例如
pyv8-win64-p3.zip(Win64 + Python 3) - 解压后把全部内容(含
__init__.py和pyv8.pyd或pyv8.so)塞进Packages/PyV8/目录 - 注意:文件夹名必须是
PyV8(首字母大写),不能小写,也不能叫pyv8 - 重启后打开控制台(Ctrl+`),观察有无
ImportError或ModuleNotFoundError: No module named 'PyV8'
最常被忽略的是:Sublime 不会提示“放错位置”,它只是沉默地跳过;ignored_packages 列表也从不报错,只让插件彻底消失。验证是否真正加载,得看控制台有没有报错、命令面板能否调出对应命令、右下角语法标识是否变化 —— 这些比“文件放进去”更能说明问题。











