必须先确认sublime text版本号再选对应安装路径：打开help→about sublime text，以弹窗显示的“sublime text 4”或“sublime text 3”为准；st4用户须用含hashlib.sha256且url以https://www.php.cn/link/05d446b21e401cdc44ea5ddb67ff0031开头的脚本，st3脚本不含sha256校验；自动安装推荐st4用命令面板触发，st3/st4均可通过控制台粘贴官网动态脚本；网络受限时需手动下载.sublime-package文件拖入installed packages目录并重启验证。
Sublime Text 4用户执行旧版脚本后控制台无报错却搜不到Install Package命令，ST3用户粘贴ST4脚本直接报module 'urllib' has no attribute 'request'，这些都不是手误，而是版本与脚本不匹配导致的静默失效——必须先确认版本再选对应安装路径。
确认Sublime Text版本号
打开Sublime Text → 点击菜单栏Help → About Sublime Text，顶部显示的必须是【Sublime Text 4】或【Sublime Text 3】。别看文件夹名、别猜、别信安装包名称，只认这个弹窗里的真实版本字符串。
2026年7月起，绝大多数新装用户默认使用ST4；若显示为ST4但你手头只有带bf11abc3哈希的脚本，立刻丢弃——它已失效。
自动安装（推荐给网络通畅用户）
方法一：命令面板一键触发（仅限ST4）
按Ctrl+Shift+P（macOS用Cmd+Shift+P）→ 输入Install Package Control → 回车 → 等待3秒，状态栏出现“Package Control: Successfully installed Package Control”即完成。
方法二：控制台执行动态脚本（ST3/ST4均适用，但脚本不同）
按Ctrl+`打开控制台 → 前往packagecontrol.io页面顶部，复制当前动态生成的Python脚本 → 粘贴进控制台 → 回车。
注意：ST4脚本必须含hashlib.sha256且URL以https://www.php.cn/link/05d446b21e401cdc44ea5ddb67ff0031开头；ST3脚本不含sha256校验，URL可能含http://（但会自动跳转HTTPS）。
执行后黑屏几秒属正常，满5秒再看状态栏提示；若只显示reloading plugin且无成功提示，说明网络层被拦截，立即切手动安装。
手动安装（网络受限/系统权限拦截时唯一有效方案）
第一步：关闭Sublime Text
确保进程完全退出，任务管理器/活动监视器中无sublime_text残留进程。
第二步：定位Installed Packages目录
打开Sublime Text → Preferences → Browse Packages… → 在文件管理器中向上退一级，进入与Packages同级的【Installed Packages】目录（不是Packages/，更不是Packages/Package Control/）。
第三步：下载并拖入官方.sublime-package文件
访问https://www.php.cn/link/05d446b21e401cdc44ea5ddb67ff0031Package%20Control.sublime-package（注意空格是%20，不是下划线也不是删掉）→ 下载该文件 → 直接拖进上一步打开的Installed Packages文件夹 → 不要解压、不要改名、不要放进Packages子目录。
第四步：重启并验证
重新打开Sublime Text → Ctrl+Shift+P → 输入Package Control: List Packages → 能弹出窗口（哪怕列表为空）即成功。若仍搜不到，说明文件没放对位置或没重启。
