
Package Control离线安装必须用.sublime-package文件直投Installed Packages/
ST4环境下,控制台里出现“Package Control installed”不等于真装上了——旧脚本会静默失败,唯一可靠方式是手动把Package Control.sublime-package文件放进Installed Packages/目录。别解压、别改名、别嵌套子文件夹,否则Sublime直接无视。
先确认版本:打开控制台(Ctrl + `),运行sublime.version(),返回值必须是4xxx。如果不是,你可能在用ST3,路径和兼容性都不同,得另处理。
- 关闭所有Sublime进程(Windows右键任务栏选「退出」,macOS菜单栏选「Quit Sublime Text」)
- 进
Installed Packages/目录,删掉所有含Package Control字样的文件(包括残留的Package Control.sublime-package和可能存在的文件夹) - 从可信镜像下载完整包:https://www.php.cn/link/becebedf1c232fd3fcd44dcd8c0ef821(注意URL中空格是
%20) - 检查文件大小:必须在
180–220 KB之间;小于100 KB说明下载不全,丢弃重试 - 把下载好的
Package Control.sublime-package文件直接拖入Installed Packages/根目录
路径错了就等于没装,必须用sublime.installed_packages_path()验证
别凭记忆或“看起来像”就放文件。Windows、macOS、Linux的Installed Packages/路径完全不同,且ST4和ST3还差一个数字。靠错路径装10次都不如查一次真实路径。
重启Sublime后,立刻打开控制台,执行:print(sublime.installed_packages_path())。它返回的才是Sublime真正读取.sublime-package的位置。
- Windows典型路径:
%APPDATA%\Sublime Text 4\Installed Packages\ - macOS典型路径:
~/Library/Application Support/Sublime Text 4/Installed Packages/ - Linux典型路径:
~/.config/sublime-text-4/Installed Packages/ - 如果返回路径和你放文件的位置不一致,说明你放错了地方,重来
装完仍找不到Install Package?验证加载成功的唯一方法
菜单里有Package Control项、控制台提示installed、甚至能进Package Settings——这些都不是真正加载成功的证据。唯一靠谱验证方式是命令面板能否执行Package Control: List Packages。
重启后按Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS),输入Package Control: List Packages。如果命令可选且执行后返回一个列表(哪怕为空),说明Package Control已加载成功;如果根本搜不到这条命令,就是没装上,回前两步检查路径和文件完整性。
- 常见假信号:
ImportError: No module named 'package_control',说明Python模块根本没导入,不是网络问题,是本体缺失 - 如果命令能搜到但执行报错
AttributeError: 'NoneType' object has no attribute 'get',大概率是残留旧版干扰,再清一遍Installed Packages/ - 别信“重启一次就好”,必须完全退出进程再启动,后台常驻的Sublime会缓存旧状态
GitHub插件不能直接扔ZIP,必须重命名后放Packages/根目录
Package Control只是包管理器,它本身不负责插件加载。你离线装的其他插件(比如Emmet、Origami)必须走另一条路:解压后重命名,整体扔进Packages/目录,而不是Installed Packages/。
从GitHub点Download ZIP得到的压缩包,解压后默认是Emmet-master/或ConvertToUTF8-main/——这层后缀是GitHub自动生成的包装壳,Sublime根本不认。
- 打开
Preferences → Browse Packages…,这就是你要往里塞插件的Packages/目录 - 把解压后的文件夹重命名为官方名:
Emmet-master/→Emmet/,Origami-dev/→Origami/ - 名字必须大小写严格一致,不能多空格、不能加下划线、不能带
-master后缀 - 整个重命名后的文件夹直接拖进
Packages/根目录(不是子文件夹,也不是Installed Packages/)
路径、命名、目录层级这三处,错任何一处都会静默失败——没有报错,没有提示,插件就是不生效。这是离线安装最常被忽略的细节。











