插件安装卡住或提示无包可用，主因是Package Control的channel文件加载失败；应更换为国内镜像地址并重启Sublime；SSL错误需更新cacert.pem证书；依赖模块须以.sublime-package格式放入Packages目录；插件不生效需检查ignored_packages配置、文件夹命名及路径是否正确。
插件安装卡住或提示“There are no packages available”
这通常不是插件本身的问题，而是 Package Control 拿不到插件列表——本质是 channel 文件加载失败。打开 Preferences → Package Settings → Package Control → Settings – User，检查 "channels" 里是否只有一条旧地址（比如 "https://packagecontrol.io/channel_v3.json"），而该地址在国内常被拦截或 DNS 解析失败。
- 直接在浏览器中打开这个 URL，如果打不开，说明网络不通，别硬等；
- 换成国内镜像更可靠：
"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json"； - 若用绝对路径引用本地 channel 文件（如
"C:/sublime/channel_v3.json"），务必确认文件真实存在且 JSON 格式合法； - 改完配置后必须重启 Sublime，否则不生效。
安装时报 SSL 错误或证书验证失败
错误信息类似 SSL: CERTIFICATE_VERIFY_FAILED，常见于企业网络、代理环境或系统证书过期。临时关掉验证（"ssl_verification": false）能绕过，但不安全也不治本。
- 真正修复方式是替换内置证书：进入
Packages/Package Control/certifi/cacert.pem（通过Preferences → Browse Packages…打开）； - 从
https://www.php.cn/link/5fe4dadcdb001d8566cd20e6d8a20251下载最新cacert.pem，覆盖原文件； - 确保
"ssl_verification": true（默认值），重启后即可走正常 HTTPS 验证； - Sublime Text 4 中该路径可能不存在，可先手动创建
Packages/Package Control/certifi/目录再放进去。
插件装上了却不生效，控制台报 ImportError
典型现象是命令面板搜不到插件命令、设置项不出现、快捷键无响应，控制台反复刷出 ImportError: No module named 'mdpopups'。这不是插件坏了，是它依赖的模块没装对。
- Sublime 的 Python 环境完全隔离，
pip install无效，所有依赖必须以.sublime-package形式放进Packages/目录； - 去对应仓库 Releases 页面下载官方发布的
mdpopups.sublime-package（不是源码 ZIP），放入Packages/； - 同理，
python-jinja2要用 skuroda 维护的 Sublime 分支，pygments要下完整版pygments.sublime-package； - 装完别忘了重启，否则不会重新扫描依赖。
手动安装后仍不识别，或插件名出现在 ignored_packages 里
Package Control 在启动时会静默禁用不兼容、签名异常或结构不全的插件，禁用列表藏在 "ignored_packages" 配置中，你根本看不到提示。
- 按
Ctrl+Shift+P输入Preferences: Package Control，看输出里有没有目标插件名出现在ignored_packages字段； - 打开
Preferences → Settings – User，找到"ignored_packages"数组，把插件名（如"Emmet"）删掉； - 检查
Packages/目录下插件文件夹是否真的有内容：至少得有.py主文件和.sublime-settings；空文件夹或只有package-control.cache就是安装失败； - 路径命名必须严格匹配插件名（如 GitHub 仓库叫
emmet-sublime，文件夹就得叫Emmet，大小写都不能错）。
最容易被忽略的是：改了 ignored_packages 或替换了证书后，不重启 Sublime 就等于没做；还有就是把 .sublime-package 丢进了 Installed Packages/ 而不是 Packages/——后者才是 Sublime 启动时自动解压并加载的位置。
