Package Control是Sublime Text的包管理框架而非插件，ST4必须用带SHA256校验的新脚本安装，旧脚本会静默失败；需先清空Installed Packages/中所有相关文件，再执行官方控制台命令，最后通过Ctrl+Shift+P验证Package Control: List Packages是否可用。
Package Control 本身就得离线装，别信“自动安装成功”
Sublime Text 4 启动后 Ctrl+Shift+P 搜不到 Package Control: Install Package，基本等于它根本没加载。控制台里出现 Package Control installed 提示不等于真装上了——ST4 用旧脚本会静默失败。先运行 sublime.version() 确认版本号是 4xxx，然后必须删干净 Installed Packages/ 目录下所有带 Package Control 字样的文件（包括 Package Control.sublime-package），再用带 hashlib.sha256 校验的新脚本重装。
.sublime-package 和解压文件夹不能混放，路径错一个字都不行
Sublime 对目录有硬性区分：
-
.sublime-package文件必须扔进Installed Packages/目录（不是Packages/） - 从 GitHub 下载 ZIP 解压出来的文件夹，必须整体放进
Packages/目录（不是子目录！） - 文件夹名必须和插件官方名完全一致，大小写敏感，比如
EmacsProMode，不能是emacspromode或EmacsProMode-master
手动装插件后不生效？先查 ignored_packages 和语法作用域
插件放对位置 ≠ 自动工作。常见失效原因：
- 用户设置里写了
"ignored_packages": ["Emmet"]，刚放进去的插件名在列表里就会被跳过 - 插件只在特定语法下触发，比如
Vue Syntax Highlight只响应.vue文件或text.html.vue作用域，打开纯.html文件时完全静默 - 右下角状态栏点开确认当前语法是否匹配；不匹配就按 Ctrl+Shift+P 输入
Set Syntax: Vue手动切换
PyV8 这类带二进制依赖的插件，离线装要补全整个文件夹结构
Sublime Text 4 已彻底移除 PyV8，但某些老插件仍强依赖它。若必须用 ST3 兼容版：
- 去 Gitee 镜像站下载对应系统的包，例如
pyv8-win64-p3.zip - 解压后把全部内容（含
__init__.py和pyv8.pyd或pyv8.so）塞进Packages/PyV8/目录 - 注意：文件夹名必须是
PyV8（首字母大写），不能小写，也不能叫pyv8
重启 Sublime Text 是硬性步骤，但更关键的是——插件是否真正加载，得看控制台有没有报错、命令面板能否调出对应命令、右下角语法标识是否变化。这些比“文件放进去”更能说明问题。
