Package Control未显示需先确认是否安装成功，执行官网代码安装并重启；列表空白则检查channels地址是否为v3 JSON；插件不可用需检查ignored_packages设置；离线安装须严格按命名和路径规范操作。
Package Control: Install Package 命令不出现
这说明 Package Control 根本没装好，或者被损坏了——不是网络问题，是底层缺失。别急着换源或配代理，先确认它是否存在。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control，看有没有任何提示；什么都没有，就是没装上 - 打开控制台：
View → Show Console，粘贴官网最新安装代码（ST4 对应的是带sublime.installed_packages_path()的那段），回车执行；注意末尾是否出现successfully installed或写入路径日志 - 如果控制台报
urllib.error.URLError或连接超时，说明网络卡在第一步，此时才需要考虑镜像或离线方案 - 装完必须重启 Sublime，再搜
Install Package，能出来才算真正生效
点开 Install Package 后空白或卡住不动
这是“列表加载失败”，本质是 Package Control 拿不到插件索引 JSON。常见于国内网络环境，但错误位置常被误判为插件本身问题。
- 打开
Preferences → Package Settings → Package Control → Settings – User，检查"channels"里是不是空的，或者只有一条旧地址；推荐替换为可用的 v3 地址："https://www.php.cn/link/773ac275840384ef9c3704eae98ff82a/channel_v3.json" - 把上面这个 URL 粘到浏览器里直接访问，能打开并看到 JSON 内容，说明地址和网络都 OK；打不开就换热点、关杀毒软件（火绒/360 常静默拦截 Sublime 的 Python 请求）
- 如果控制台报
schema_version mismatch，说明你用了 v2 channel 文件匹配新版Package Control，必须统一用channel_v3.json - 临时删掉
Packages/Installed Packages/Package Control.sublime-package，再重装一次官方包，比修配置更快
插件明明装上了，但命令面板找不到、快捷键无效
不是没装成，而是被 Sublime 主动忽略了——ignored_packages 列表在后台悄悄屏蔽了它。
- 打开控制台，搜索
ignored_packages或disabled packages，看输出里有没有你的插件名；有就说明它被自动加入黑名单 - 编辑用户设置：
Preferences → Settings – User，找到"ignored_packages"这一行，把它整个删掉，或从中移除对应插件名（比如"EmacsProMode"） - 保存后必须重启 Sublime，否则不生效；重启后观察控制台是否出现
reloading plugin EmacsProMode.xxx，有就代表加载成功 - 某些插件（如依赖 PyV8 的 Emmet）在 ST4 下因 API 变更彻底失效，此时控制台会报
ImportError，这类只能换替代插件，重装无用
离线安装插件总失败？关键在文件夹命名和位置
手动放插件不是“解压完拖进去”就行，Sublime 对路径、命名、结构极其敏感，错一个字符就不认。
- 去
https://packagecontrol.io/packages/插件名页面，点 “Source” 跳转到 GitHub，再点Code → Download ZIP；不要从其他镜像或第三方站下载 - 解压后得到类似
SomePlugin-master的文件夹，必须重命名为SomePlugin（去掉-master，不加任何后缀，大小写必须和官网页面显示的完全一致） - 复制到正确路径：
Windows：C:\Users\用户名\AppData\Roaming\Sublime Text 4\Packages\
macOS：~/Library/Application Support/Sublime Text 4/Packages/
Linux：~/.config/sublime-text-4/Packages/ - 重启 Sublime 后，去
Preferences → Package Settings看有没有对应菜单；没有就打开控制台，查是否有ImportError或路径not found
最常被跳过的环节是：没清掉旧的 Package Control.sublime-package 就强行换源，或手动安装时保留了 -master 后缀。这两个动作看似微小，却直接决定插件能否被识别——不是 Sublime 不行，是它太较真。
