sublime text 插件应通过 package control 安装，手动安装在 st4 中不可靠；安装失败主因是脚本版本不匹配、网络拦截或路径异常；搜不到插件需先确认仓库加载状态；热门插件需针对性配置路径、主题或刷新侧边栏；插件加载顺序依赖文件名前缀，同名插件可能被静默覆盖。
Sublime Text 的插件生态不是“装得越多越好”，而是“装对了才省事”。Package Control 是唯一值得信任的安装入口，手动解压、拖文件进 Packages 目录的方式在 Sublime Text 4（Build 4169+）中已不可靠，容易导致插件不加载、配置丢失或启动卡死。
Package Control 安装失败的三个真实原因
控制台粘贴代码后没反应、报错 urllib.error.URLError 或提示 invalid syntax，基本逃不开这三种情况：
- 你用的是 Sublime Text 4，但粘了 ST3 的旧安装脚本（比如含
hashlib.sha256校验那段）——ST4 已移除部分 Python 3.3 特性，必须用官网最新脚本 - 系统代理或防火墙拦截了
http://packagecontrol.io，而 Sublime 不读系统全局代理，也不能配 PAC —— 此时别硬等，直接去https://packagecontrol.io/Package%20Control.sublime-package手动下载文件，放进Installed Packages文件夹后重启 -
sublime.installed_packages_path()返回空路径，常见于便携版或自定义安装路径的用户 —— 先在控制台运行print(sublime.installed_packages_path())确认路径，再手动建目录或改权限
Install Package 搜不到插件？先看仓库加载状态
按下 Ctrl+Shift+P → 输入 Install Package 回车后，左下角如果一直显示 Loading repositories... 超过 30 秒，说明远程仓库没拉下来，后续所有搜索都无效。这不是插件不存在，而是本地索引为空。
此时不要反复重试，更不要关掉面板再开 —— 这会重置加载队列。正确做法是：
- 打开命令面板，输入
Package Control: List Packages，如果报错或列表为空，确认是仓库问题 - 临时关闭杀毒软件（尤其是 Windows Defender 实时防护，它常静默拦截 Sublime 的 HTTPS 请求）
- 在
Preferences → Package Settings → Package Control → Settings中，把"channels"数组里的默认地址替换成镜像源，例如："https://ghproxy.com/https://raw.githubusercontent.com/wbond/package_control-channels/master/channel_v3.json"
Terminus、A File Icon 这类热门插件的兼容陷阱
它们不是“装上就亮”，实际使用中高频出问题的点很具体：
-
Terminus在 Windows 上默认调用cmd，但如果你配置了git-bash或WSL，需手动编辑Terminus.sublime-settings，把"shell_cmd"改成"C:\Program Files\Git\bin\bash.exe"或对应 WSL 路径，否则面板打开即崩溃 -
A File Icon和大多数第三方 UI 主题（如ayu、Origami）存在 CSS 选择器冲突，图标不显示时别急着重装 —— 先在Preferences → Color Scheme切回Adaptive或Monokai原生主题测试，确认是主题问题再查该主题的 issue 页面找 patch - 所有带图形界面配置的插件（如
SideBarEnhancements右键菜单），首次启用后必须右键刷新侧边栏，否则新选项不会出现 —— 这不是 bug，是 Sublime 的 event loop 机制决定的
最易被忽略的一点：Sublime Text 4 的插件加载顺序依赖文件名前缀。如果你手动放了两个同名插件（比如都叫 Emmet），一个来自 Package Control，一个来自 GitHub clone，后者会覆盖前者且不报错 —— 查 Packages 目录时注意看文件夹名是否带 .disabled 后缀，那是 Package Control 的保护机制，别手贱删掉。
