Sublime Text 4必须用官网带SHA256校验（哈希值以6f4c264a开头）的Python 3脚本安装Package Control，执行后重启并验证Ctrl+Shift+P可调出Install Package命令才算成功。
Sublime Text 4（2026年主流版本）必须用带 SHA256 校验的 Python 脚本直连安装，手动拖文件仅是备用方案；所有“解压 zip 到 Packages 目录”或“复制旧博客脚本”的做法，大概率导致命令面板卡死、Install Package 命令不出现。
怎么确认自己该用哪个安装脚本？
打开 Help → About Sublime Text，看顶部显示的是 Sublime Text 3 还是 Sublime Text 4——别猜，版本错一个字，脚本就静默失效。ST4 必须用哈希值以 6f4c264a 开头、请求地址为 https://packagecontrol.io/ 的脚本；ST3 脚本哈希通常以 bf11abc3 或 7183a2d3 开头，且旧版多用 HTTP 协议（现在 packagecontrol.io 已强制重定向 HTTPS，改 http 反而触发连接中断）。
- 别复制第三方博客里带 “v3.3.1”“2022 年更新” 等时间戳的代码——
https://packagecontrol.io/页面顶部动态生成的脚本才是唯一可信来源 - 粘贴后控制台只显示
reloading plugin或无反应？不是手速问题，而是 TLS 握手失败或 DNS 解析超时，等满 5 秒再判断 - 状态栏弹出
Package Control: Successfully installed Package Control才算真成功；仅菜单里有Package Settings → Package Control是旧版残留，不可信
执行控制台脚本失败怎么办？
报 CertificateError、URLError，或 macOS 提示 Operation not permitted，说明系统策略或网络沙盒拦截了 HTTPS 请求。此时必须切手动安装，且路径和文件名不能错半字：
- 先在控制台执行
sublime.installed_packages_path()查真实路径（ST4 默认是Sublime Text/Installed Packages，不是Sublime Text 4/...） - 下载地址必须是
https://packagecontrol.io/Package%20Control.sublime-package（注意空格被编码为%20） - 文件名必须严格为
Package Control.sublime-package，不能解压、不能改后缀、不能加数字或下划线 - 扔进
Installed Packages/后必须重启 Sublime，否则插件加载器根本不会扫描它
装完为什么 Install Package 搜不到插件？
不是插件源没加载，而是 Package Control 默认首次运行时才拉取 channel 列表，这个过程不提示、不报错、不弹窗——你得等：
- 按
Ctrl+Shift+P→ 输入Install Package→ 回车 → 光标变空转圈状态，这是正常现象；等 3–8 秒，列表才会出来 - 等满 15 秒还是空？执行
Package Control: Synchronize Packages强制刷新，比重启 Sublime 有效得多 - 检查
Preferences → Package Settings → Package Control → Settings – User里"channels"是否为默认值："https://packagecontrol.io/channel_v3.json" - 某些插件名大小写敏感，比如搜
emmet没结果，但输Emmet就有；右下角状态栏看当前语法是否匹配（如Vue Syntax Highlight只在.vue文件下生效）
装完第一件事：同步仓库 + 安装中文支持
刚装好的 Package Control 默认只缓存极简元数据，不立刻同步仓库，会导致搜不到插件。另外，ST 原生界面是英文，中文用户容易误判功能位置：
- 先运行
Package Control: Synchronize Packages，强制刷新本地仓库缓存 - 再运行
Package Control: Install Package，搜ChineseLocalizations（注意拼写，不是 ChineseLocalization） - 装完后重启 Sublime，界面即变中文；此后所有插件名、命令面板提示都可按中文理解
最常被忽略的一点：手动安装后若仍无效，进 Installed Packages/ 目录删掉所有含 Package Control 字样的文件再重试——旧版残留干扰极强，会静默覆盖新安装。
