Package Control安装失败主因是网络问题、channel失效、缓存污染或路径权限错误；需先确认是否安装成功，再检查channel地址有效性、系统时间、ignored_packages设置及插件路径格式。
插件安装失败，八成不是你操作错了，而是 Package Control 拿不到资源——网络被墙、channel 地址失效、缓存污染或路径权限错位，四个环节任一卡住都会表现为“点不动”“列表空”“装了没反应”。
Package Control 根本没装上，Install Package 命令不出现
这是最常被跳过的前置问题。按 Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS），输入 Package Control，如果完全无响应，说明它压根没装进 Sublime 的运行时环境。
- 打开控制台：
View → Show Console，粘贴 ST4 官方手动安装代码（含sublime.installed_packages_path()调用的那一版），回车执行 - 看到
Success或写入路径日志才代表文件已落盘；若报URLError或超时，别重试，直接切到换源步骤 - 装完必须重启 Sublime，再搜
Install Package，能出来才算生效 - 系统时间误差超过 5 分钟会导致 SSL 验证失败，控制台报
ssl.CertificateError时先校准系统时间
There are no packages available for installation 列表为空
这个提示本质是 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 的 channel 地址在 2026 年已全部 404
- 如果控制台报
schema_version mismatch，说明用了 v2 channel 匹配新版 Package Control，必须统一用channel_v3.json
插件装上了但命令面板找不到、快捷键无效
不是没装成，是被 Sublime 主动忽略了。常见于路径放错、ignored_packages 屏蔽、或依赖模块缺失。
- 检查
Preferences → Settings用户配置中是否有"ignored_packages": ["xxx"]，刚装的插件名在里面就会被静默屏蔽 - 确认插件类型：
.sublime-package文件必须放进Installed Packages/目录；ZIP 解压后的文件夹必须整体放进Packages/（不能嵌套子目录） - 依赖报错如
ImportError: No module named 'mdpopups'，说明插件需要的底层模块没装对——Sublime 的 Python 环境隔离，pip install无效，必须下载对应仓库发布的mdpopups.sublime-package手动丢进Installed Packages/ - 部分插件（如
SublimeCodeIntel）还依赖作用域匹配，打开文件后右下角状态栏看语法是否为对应语言，不是就手动Set Syntax
手动安装插件时路径和格式总出错
手动是绕过网络最稳的方式，但路径和命名稍有偏差就会失效。
- Windows 路径示例：
C:\Users\用户名\AppData\Roaming\Sublime Text 3\Installed Packages\（放.sublime-package文件） - macOS 路径示例：
~/Library/Application Support/Sublime Text 3/Packages/（放解压后的插件文件夹） - 文件夹名必须简洁，如
ConvertToUTF8，不能带-master或空格；.sublime-package文件名必须与插件 ID 一致（查插件主页的 Releases 页面） - 装完必须重启 Sublime，仅刷新或重载不会触发新插件加载
- 如果插件含二进制组件（如某些 LSP 客户端），还需确认系统架构匹配（x86_64 vs arm64）
真正卡住的往往不是技术细节，而是“以为装好了”——比如控制台没报错就认为成功，其实只是缓存返回了旧状态；或者换了镜像却没验证浏览器能否打开那个 JSON 地址。每一步都建议用最直白的方式验证：能看见、能打开、能写入、能重启。
