package control命令面板不出现说明未加载，需先验证sublime版本（sublime.version()），st4必须用含urllib.request和hashlib.sha256的脚本，手动安装须将package control.sublime-package严格放入installed packages/目录并完全退出重启。
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 脚本。务必去官网页面，按你当前的
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/azl397985856/package_control_channel/raw/master/channel_v3.json" - 把该 URL 粘到浏览器里直接访问，能加载出完整 JSON 才算有效；打不开就换网络、关杀毒软件（火绒/360 常静默拦截
urllib请求） - 别用博客里抄的旧链接，比如某些 php.cn 的
channel地址在 2026 年已全部 404 - 如果控制台报
schema_version mismatch，说明用了 v2 channel 匹配新版 Package Control，必须统一用channel_v3.json
.sublime-package 文件该放 Installed Packages 还是 Packages？
放错路径是手动安装失效的第一原因，Sublime 对这两个目录有硬性分工：
-
.sublime-package文件（如EmmyLua.sublime-package）→ 必须直接丢进Installed Packages/，不要解压，重启即生效 - GitHub 下载的 ZIP 解压后得到的文件夹（如
Emmet/）→ 必须整体复制进Packages/根目录，不能嵌套、不能改名（比如不能叫Emmet-master/） - 用
Preferences → Browse Packages…打开的路径就是Packages/；它的上一级目录里的Installed Packages/才是另一个位置 - 不确定路径？在控制台运行
print(sublime.installed_packages_path())和print(sublime.packages_path())查真实路径
最常被忽略的是：手动放入 Package Control.sublime-package 后必须完全退出并重启，否则插件加载器根本不会扫描它；哪怕文件名差一个空格、路径多一层、或者没删干净旧残留，都会导致静默失败。
