Sublime Text 4 安装 Package Control 必须满足版本 ≥4107，通过控制台执行官方 Python 脚本或手动拖入 .sublime-package 文件至正确 Installed Packages 目录，并验证加载与同步状态。
确认 Sublime Text 4 版本号再动手
别跳过这步——sublime.version() 返回值必须 ≥4107，否则脚本会静默失败。按 Ctrl+`（Windows/Linux）或 Cmd+`（macOS）打开控制台，输入 sublime.version() 回车。如果返回 4106 或更低，直接去 https://www.php.cn/link/de3a1d8c27100134e970acb749429fca 下载最新版。旧版 ST4 无法执行当前带 hashlib.sha256 校验的安装逻辑。
用官方 Python 脚本直连安装（首选）
打开 Help → About Sublime Text，确认顶部显示的是 Sublime Text 4（不是 ST3 或 ST4.0 这类模糊写法）。然后严格复制以下整行代码，一次性粘贴到控制台并回车：
import urllib.request,os,hashlib;exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8'))
关键点：
- 必须等满 5 秒再判断结果——TLS 握手慢时前几秒可能完全没输出
- 成功唯一标志是状态栏弹出
Package Control: Successfully installed Package Control - 出现
CertificateError、URLError或 macOS 提示Operation not permitted，说明 HTTPS 请求被系统或网络拦截，此时立即切手动方式 - 别删脚本里的
hashlib.sha256或改https为http——packagecontrol.io已强制重定向，反而触发更隐蔽中断
手动安装时三处不能错
手动不是“解压 zip 到 Packages 目录”，而是把官方 .sublime-package 文件原样拖进 Installed Packages/。操作顺序必须是：
- 先在控制台执行
sublime.installed_packages_path()查真实路径（ST4 默认是Sublime Text/Installed Packages，不是Sublime Text 4/） - 访问
https://packagecontrol.io/Package%20Control.sublime-package下载文件（注意 URL 中空格是%20，不是下划线或删掉） - 关闭 Sublime Text，把下载好的
Package Control.sublime-package（后缀名必须完整保留，不能解压、不能改名、不能加数字）拖进Installed Packages/目录，再重启 - 拖之前务必清空该目录下所有含
Package Control字样的旧文件（包括备份文件），否则加载冲突
装完立刻验证同步状态
重启后别急着搜插件——首次拉取插件列表要时间，且不提示。必须按顺序验证：
-
Ctrl+Shift+P输入Package Control: List Packages，能弹出列表（哪怕为空）才算框架加载成功 - 再输入
Package Control: Install Package回车，状态栏应显示Fetching list of available packages - 首次加载通常需 5–10 秒，光标转圈是正常现象；等满 15 秒仍无反应，执行
Package Control: Synchronize Packages强制刷新 - 检查
Preferences → Package Settings → Package Control → Settings – User中"channels"是否为默认值："https://packagecontrol.io/channel_v3.json"
真正卡住的地方往往不是安装本身，而是装完后没等够那几秒，或者误把 Installed Packages/ 和 Packages/ 搞混——这两个目录平级，拖错位置就等于白装。
