package control.sublime-package 必须精确放入installed packages/目录且文件大小为180–220 kb，删除旧版残留、核对镜像url、验证路径/菜单/控制台三处一致，并确保未被ignored_packages屏蔽。
Package Control.sublime-package 必须放 Installed Packages/ 目录
ST4 启动后 Ctrl+Shift+P 搜不到 Package Control: Install Package，基本等于它根本没加载——哪怕控制台里出现 Package Control installed 提示，也可能是旧脚本静默失败。关键不是“有没有提示”，而是命令面板能否调出功能。
-
.sublime-package文件只能进Installed Packages/，不能放Packages/，也不能解压、改名、塞子目录 - 路径必须精准：
Windows：%APPDATA%\Sublime Text 4\Installed Packages\
macOS：~/Library/Application Support/Sublime Text 4/Installed Packages/
Linux：~/.config/sublime-text-4/Installed Packages/ - 文件大小必须在 180–220 KB；小于 100 KB 说明下载不全，丢弃重试
ST4 必须清空旧 Package Control 再重装
残留的旧版 Package Control.sublime-package 会劫持命令通道，导致新包加载失败。ST4 对安装脚本有硬性校验要求，旧版（无 hashlib.sha256 校验）会静默退出，不报错也不生效。
- 先关闭所有 Sublime Text 进程（包括后台）
- 进入
Installed Packages/目录，删掉所有含Package Control字样的文件（包括Package Control.sublime-package和可能存在的Package Control 3.sublime-package等） - 运行
sublime.version()确认返回值是4xxx，再执行后续步骤
下载源和文件完整性验证不能跳过
packagecontrol.io 域名已不可靠，直接访问会失败或跳转到不可信页面。国内镜像虽可用，但部分缓存链接已失效，必须核对 URL 和文件大小。
- 推荐镜像地址（URL 中空格为
%20）：https://www.php.cn/link/7574933a1b39d861a171370e4582ec28 - 不要用浏览器“另存为”直接点下载——某些代理或拦截插件会截断内容，导致文件损坏
- 下载后右键属性查大小，或用命令行
ls -lh Package\ Control.sublime-package（macOS/Linux）/dir "Package Control.sublime-package"（Windows）确认尺寸
重启后必须验证三个位置是否一致
只打开软件不算完成，必须交叉验证路径、菜单、控制台三处是否同步生效。任何一处不匹配，说明加载路径错位或被忽略。
- Preferences 菜单下应出现
Package Control和Package Settings两项 - Ctrl+Shift+P 输入
Install Package应能立即匹配并执行 - 控制台中运行
sublime.installed_packages_path()，返回路径必须与你拖入文件的实际路径完全一致（注意斜杠方向、空格、大小写）
最容易被忽略的是 ignored_packages 配置项——即使 Package Control 已加载，若它被列在用户设置的 "ignored_packages" 数组里，也会彻底消失。检查 Preferences → Settings 右侧用户配置，删掉相关条目再重启。
