package control命令面板不出现说明其本体未加载，根本原因是package control.sublime-package文件放错目录（应放入installed packages/而非packages/）、未完全退出重启或残留旧文件冲突；控制台报sslcertverificationerror是内置证书过期所致，需手动更新cacert.pem；install package空白则因channel源失效，须改用清华镜像并重启。
Package Control命令面板不出现，说明根本没加载
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）搜不到 Package Control: Install Package，不是插件装不上，是 Package Control 连运行时都没进。别急着装插件，先确认它是否存在：
- 打开控制台（
Ctrl+`），执行sublime.version()：返回4xxx是 ST4，必须用含urllib.request和hashlib.sha256的脚本；返回3xxx才能用旧版 - 执行
sublime.installed_packages_path()，去文件系统里检查该路径下的Installed Packages/目录，看有没有Package Control.sublime-package - 如果有但命令仍不出现，大概率是旧残留文件干扰——删掉
Installed Packages/下所有含Package Control字样的文件（包括Package Control (old).sublime-package），再重跑最新脚本 - 重启必须是「完全退出」：Windows 右键任务栏图标选「退出」，macOS 菜单栏选「Sublime Text → Quit Sublime Text」，只关窗口无效
控制台执行脚本后静默失败或报错
粘贴官网脚本回车后，控制台没输出、闪退、或报 NameError: name 'urllib2' is not defined / ModuleNotFoundError: No module named 'urllib.request'，说明版本和脚本严重 mismatch：
- ST4 用户绝不能用 ST3 脚本；ST3 用户也不能直接套用 ST4 脚本。务必去 https://www.php.cn/link/befa130dcb31961fa251d61e1e6ba0e1 页面，按你当前的
sublime.version()结果，复制对应区块的「Manual Installation」代码 - 粘贴前，先在控制台敲
import urllib.request回车：报错就证明你手里的脚本根本不适配当前版本 - 别从网页截图、PDF 或博客复制脚本——容易带不可见字符（全角空格、零宽字符），导致 Python 解析失败；必须从官网页面直接复制整段
- 执行后没看到
Success或写入路径日志，代表文件根本没落盘，不算成功
装上了却提示 “There are no packages available”
命令面板能调出 Package Control: Install Package，但点击后卡在 “Loading…” 或直接显示空列表，问题不在 Package Control 本身，而在它依赖的插件源（channel）不通：
- 打开
Preferences → Package Settings → Package Control → Settings – User，确认"channels"至少有一条可用地址，例如："https://gitee.com/akira-cn/package_control_channel/raw/master/channel_v3.json" - 把该 URL 粘到浏览器地址栏直接访问：必须能返回完整 JSON 内容才算有效；打不开就换网络、关杀毒软件（火绒/360 常静默拦截
urllib请求） - 别用已失效的镜像（如 php.cn 的链接），也别漏掉
/raw/master/路径段；保存配置后必须重启 Sublime，设置不热重载 - 如果控制台报
schema_version mismatch，说明用了 v2 channel 匹配新版Package Control，必须统一用channel_v3.json
手动安装是最稳的兜底方案
当网络环境不可控（企业防火墙、校园网、Clash/Surge 不生效），手动下载 .sublime-package 文件是最可靠方式，绕过所有 SSL 校验和域名解析环节：
- 浏览器打开 https://www.php.cn/link/2e5d5f65d3ef778b01366907d1f14445 直接下载
- Windows 路径：
%APPDATA%\Sublime Text 4\Installed Packages\；macOS：~/Library/Application Support/Sublime Text 4/Installed Packages/；Linux：~/.config/sublime-text-4/Installed Packages/ - 文件名必须是
Package Control.sublime-package（空格不能省，大小写敏感），不要解压，不要改名，不要放进Packages/目录 - 放完必须完全退出并重启 Sublime，否则不会加载
Install Package ≠ channel 已连通。每一步都得用具体命令或文件系统验证，不能靠视觉判断。
