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 列表也从不报错，只让插件彻底消失。验证是否真正加载，得看控制台有没有报错、命令面板能否调出对应命令、右下角语法标识是否变化 —— 这些比“文件放进去”更能说明问题。
