Package Control是Sublime Text内置包管理框架，非普通插件或插件中心；必须用对应版本脚本安装（ST4用installation.py动态脚本，ST3用归档哈希脚本），失败后手动将Package Control.sublime-package拖入Installed Packages/目录并清空旧文件，最后通过Ctrl+Shift+P运行Package Control: List Packages验证是否生效。
Package Control 不是“插件中心”，也不是普通插件——它是 Sublime Text 内置的包管理框架，必须正确安装才能启用 Install Package、Remove Package 等所有插件操作。控制台脚本失败后直接手动拖文件进 Installed Packages/ 是最稳兜底方案，但路径、后缀、残留文件三处极易出错。
执行控制台脚本前先确认 Sublime 版本
Help → About Sublime Text 里显示的是 Sublime Text 4 还是 Sublime Text 3？两者安装命令不兼容：Sublime Text 4 必须用带 installation.py 的动态脚本，旧版哈希校验脚本会卡在 “Installing Package Control” 状态不动；Sublime Text 3 则不能用新脚本，否则报 module 'urllib' has no attribute 'request'。
- ST4 推荐命令（2026年最新）：
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8')) - ST3 必须用归档哈希脚本，官网已不再首页展示，需从旧文档中提取
- 按
Ctrl+`打开控制台后，粘贴完务必等满 5 秒再判断——TLS 握手或 DNS 解析慢时，状态栏提示会延迟出现
手动安装时 Installed Packages/ 目录不能错
手动方式不是“把 zip 解压到 Packages/”，而是把官方下载的 Package Control.sublime-package 文件（注意后缀名完整）直接拖入 Installed Packages/ 目录。这个目录和 Packages/ 是平级的两个文件夹，搞混会导致 Package Control 加载失败甚至命令面板卡死。
- 菜单 Preferences → Browse Packages… → 关闭 Sublime → 向上退一级 → 进入
Installed Packages/ - 下载地址始终是
https://packagecontrol.io/Package%20Control.sublime-package（URL 中空格已编码） - 拖入前清空该目录下所有含
Package Control字样的旧文件，包括Package Control.cache或带时间戳的备份 - Windows 用户若发现
sublime.installed_packages_path()返回空，说明路径获取失败，手动安装是唯一可行路径
Package Control: List Packages 是唯一有效验证方式
别信菜单里突然多出的 Preferences → Package Settings → Package Control，那是旧版残留 UI。真正生效的表现只有一个：命令面板能调出并执行核心命令。
- 重启 Sublime 后，按
Ctrl+Shift+P，输入Package Control: List Packages - 如果弹出一个空列表（哪怕没装任何插件），说明 Package Control 已加载且联网成功
- 若提示
command not found，或输入Package Control后无任何补全项，说明安装未生效，需重试或检查代理配置 - 此时再查
Preferences → Package Settings → Package Control → Settings – User，确认"channels"是"https://packagecontrol.io/channel_v3.json"，不是 http 或拼写错误
最容易被忽略的是：手动安装后仍需确保网络可通 channel_v3.json，否则首次 Install Package 会无限转圈。很多用户拖进文件就以为万事大吉，结果卡在“加载仓库列表”那一步，其实是 channel 请求超时而非插件本身问题。
