404错误主因是package control未真正加载,需先确认st4版本(sublime.version()返回4xxx),彻底退出后删除installed packages/中旧文件,再将180–220kb的package control.sublime-package拖入该目录并重启。

插件安装失败提示 404,基本就是 Package Control 没真正加载
不是网络卡,也不是你操作慢——Package Control 在 ST4 上静默失败太常见了。控制台里哪怕出现 Package Control installed 字样,只要 Ctrl+Shift+P 搜不到 Install Package,就说明它根本没跑起来。
先确认版本:sublime.version() 返回值要是 4xxx(比如 4143)。如果不是,别往下试,ST3 和 ST4 的路径、机制、兼容性全不同。
- 关闭 Sublime Text 全进程(任务管理器/活动监视器里也清掉后台)
- 进
Installed Packages/目录,删光所有含Package Control字样的文件(包括Package Control.sublime-package和可能残留的Package Control.old) - 从国内镜像下载完整包:https://www.php.cn/link/7574933a1b39d861a171370e4582ec28,文件大小必须在
180–220 KB;小于100 KB就是下载不全,直接丢弃 - 把下载好的
Package Control.sublime-package文件**拖进**Installed Packages/,不改名、不解压、不套子目录
.sublime-package 文件放错位置:最常被忽略的路径错误
Sublime 对两个目录有硬性分工:Installed Packages/ 只收未解压的 .sublime-package 文件;Packages/ 只收解压后的**整个文件夹**。混放=失效,而且它不会报错,只会沉默跳过。
查真实路径别靠猜:Ctrl+` 打开控制台,运行:
print(sublime.installed_packages_path()) # 应该指向 Installed Packages/ print(sublime.packages_path()) # 应该指向 Packages/
这两个路径必须分开管理:
-
Emmet.sublime-package→ 必须进Installed Packages/ -
Emmet-master.zip解压后得到Emmet/文件夹 → 必须整体扔进Packages/根目录,不能放进Packages/User/或其他子目录 - 文件夹名必须和插件官方名**完全一致**,大小写敏感:
ConvertToUTF8≠converttoutf8≠ConvertToUTF8-master
插件放对了还是不生效?先看 ignored_packages
菜单里没入口、命令面板搜不到、快捷键没反应——八成是被 ignored_packages 列表拉黑了。这个配置项不报错、不提示,只让插件彻底消失。
打开 Preferences → Settings,看右侧用户设置里有没有这行:
"ignored_packages": ["Vintage", "Anaconda", "Emmet"]
如果你刚放的是 Emmet,它就在黑名单里。临时解决办法:
- 删掉
"Emmet"这一项,或整行注释掉(加//前缀) - 保存,重启 Sublime Text
- 再验证功能是否出现
别忘了检查语法作用域:有些插件(如 ConvertToUTF8)只在特定文件类型(.txt、.log)下才激活,普通 .py 文件里不会响应。
离线更新插件时覆盖旧文件 = 白忙活
Sublime 会缓存已导入的模块,旧代码可能还驻留在内存里。直接用新 .sublime-package 覆盖旧文件,或者把新文件夹丢进 Packages/ 同名目录,都可能触发 ImportError 或功能错乱。
正确做法是“清旧再放新”:
- 关掉 Sublime Text
- 进
Packages/,删掉整个旧插件文件夹(比如ConvertToUTF8/),或删掉旧的ConvertToUTF8.sublime-package(如果它在Installed Packages/) - 把新版本文件或文件夹放进去,确保名字完全一致(连大小写都不能差)
- 重启后立刻按
Ctrl+`看控制台:有没有reloading plugin ConvertToUTF8日志?有没有ImportError?这两条才是真实加载信号
最容易被忽略的是命名一致性与路径层级——Sublime 不会告诉你“文件夹放错了”,它只是安静地当它不存在。











