报“There are no packages available”或搜不到“Package Control: Install Package”，根本原因是Package Control未加载或channel源失效；需先执行sublime.version()确认版本，再按路径检查并重装Package Control.sublime-package，最后验证channels地址有效性并完全重启。
报 There are no packages available 或根本搜不到 Package Control: Install Package，不是插件的问题，是 Package Control 没加载或 channel 源失效——这两类问题占安装失败的 90% 以上，先确认再折腾。
Package Control 命令面板完全不出现
按 Ctrl+Shift+P（Windows/Linux）或 Cmd+Shift+P（macOS）搜不到任何 Package Control 相关命令，说明它压根没进 Sublime 运行时环境。这不是网络问题，是本体缺失或加载失败。
- 打开控制台（
Ctrl+`），执行sublime.version()：返回4xxx是 ST4，必须用含urllib.request的脚本；返回3xxx才能用旧版 - 执行
sublime.installed_packages_path()，去文件系统里检查该路径下是否存在Package Control.sublime-package - 如果有但命令仍不出现，删掉
Installed Packages/下所有含Package Control字样的文件（包括Package Control (old).sublime-package），再重跑官网对应版本的手动安装脚本 - 重启必须是「完全退出」：Windows 右键任务栏图标选「退出」，macOS 菜单栏选「Sublime Text → Quit Sublime Text」，只关窗口无效
Install Package 点开后空白或卡在 Loading…
命令能调出来，但点进去啥都没有，本质是 Package Control 请求的 channels 地址返回空 JSON 或 404。国内用户几乎全卡在这步，和插件本身无关。
- 打开
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 的地址在 2026 年已全部 404；也别用
https://packagecontrol.io/channel_v3.json，国内基本不可达 - 改完配置必须完全重启 Sublime，否则不生效
控制台刷出 SSL 错误或证书验证失败
报 ssl.CertificateError、CERTIFICATE_VERIFY_FAILED 或 ssl.SSLCertVerificationError，常见于公司网络、杀软拦截，或系统时间误差超过 5 分钟。
- 先校准系统时间：误差 >5 分钟会直接触发 SSL 验证失败
- 进入
Preferences → Browse Packages…，打开Packages/Package Control/certifi/cacert.pem；若目录不存在，手动创建Packages/Package Control/certifi/并放入最新cacert.pem（从 https://curl.se/ca/cacert.pem 下载） - 确认用户设置中
"ssl_verification": true（默认就是 true），别设成 false——那是掩耳盗铃 - 某些输入法（如 QQ 输入法、搜狗）会劫持
Ctrl+`快捷键，导致控制台打不开，先关掉输入法热键
插件装上了但命令/快捷键不响应
插件文件确实在 Packages/ 或 Installed Packages/ 里，但命令面板搜不到、快捷键无效，大概率被 Sublime 主动加入 ignored_packages 黑名单，属于“静默屏蔽”。
- 控制台输入
sublime.load_settings('Preferences.sublime-settings').get('ignored_packages')，看输出里有没有你的插件名（如"Emmet"、"ChineseLocalization"） - 打开
Preferences → Settings – User，找到"ignored_packages"这一行，把对应插件名从数组中删掉，保存后必须重启 - 不确定插件该放哪？
.sublime-package文件必须放进Installed Packages/；GitHub 下载解压后的文件夹必须整体放进Packages/根目录，且文件夹名要和仓库名一致（不能带-master后缀）
最易被忽略的是：改了 channels 或删了 ignored_packages 后不重启，等于白干；还有人把 .sublime-package 文件拖进 Packages/ 目录，Sublime 完全不认——路径错，连报错都不会有。
