Package Control不是插件而是Sublime Text的包管理框架;必须先通过控制台执行官方Python脚本(ST4用含hashlib.sha256校验的新脚本)或手动将Package Control.sublime-package拖入Installed Packages/目录,重启后验证Package Control: List Packages可用,否则所有插件安装均失败。

Package Control 没装,命令行安装插件根本走不通
Sublime Text 本身不提供原生命令行插件安装接口。所谓“命令行安装”,实际是指在 Sublime 的 Console(控制台)中执行 Python 脚本,完成 Package Control 安装后,再用它装插件——不是系统终端(Terminal / CMD)里的命令。
直接在系统终端里运行 subl --install-plugin xxx 或类似命令会报错:该选项不存在,Sublime 不支持。
常见误解是把“控制台”当成 shell 命令行。实际上它是 Sublime 内置的 Python 解释器环境,快捷键是 Ctrl+`(Windows/Linux)或 Cmd+`(macOS)。
先装 Package Control:控制台执行安装脚本
必须先让 Sublime 具备包管理能力,否则后续所有插件安装都无从谈起。官方推荐方式是通过控制台执行一段 Python 脚本:
- 打开 Sublime Text,按
Ctrl+`调出控制台 - 粘贴对应版本的安装代码(2026 年最新稳定版为 Sublime Text 4,使用以下代码):
import urllib.request,os,hashlib; h = '6f4c264a24d933ce70df5dedcf1dcaee' + 'ebe013ee18cced0ef93d5f746d80ef60'; pf = 'Package Control.sublime-package'; ipp = sublime.installed_packages_path(); urllib.request.install_opener(urllib.request.build_opener(urllib.request.ProxyHandler())); by = urllib.request.urlopen('https://packagecontrol.io/'+pf.replace(' ', '%20')).read(); dh = hashlib.sha256(by).hexdigest(); print('Error validating download (got %s instead of %s), please try manual install' % (dh, h)) if dh != h else open(os.path.join(ipp, pf), 'wb').write(by) - 回车执行,等待几秒;成功后控制台无报错,且重启 Sublime 后
Preferences > Package Settings下会出现Package Control项
用 Package Control 在控制台里“模拟命令行”装插件
虽然不能真用 shell 命令,但你可以用控制台 + sublime.run_command() 实现半自动化安装,适合批量或 CI 场景(比如配置新机器时):
- 打开控制台(
Ctrl+`),输入并执行:sublime.run_command("package_control_install_package", {"package_name": "Git"}) - 这等价于手动在命令面板里选
Package Control: Install Package→ 输入Git→ 回车 - 注意:
package_control_install_package是内部命令名,参数必须是{"package_name": "插件名"}字典格式 - 插件名必须和 Package Control 仓库里注册的完全一致(比如
SideBarEnhancements,不是sidebar或sidebarenhancement) - 失败时控制台不会报错,但状态栏会显示
Failed to install Git—— 这通常意味着网络不通、插件名拼错,或仓库暂时不可达
手动复制插件到 Packages 目录也算“命令行友好”方案
如果你有插件源码或 .sublime-package 文件,且希望绕过网络和 Package Control,可以直接用 shell 命令完成部署:
- 找到 Packages 目录路径:
Linux:~/.config/sublime-text/Packages
macOS:~/Library/Application Support/Sublime Text/Packages
Windows:%APPDATA%\Sublime Text\Packages - 用
git clone或curl下载插件到本地,例如:cd ~/.config/sublime-text/Packages && git clone https://gitcode.com/gh_mirrors/su/sublime-text-git.git Git
- 重启 Sublime Text,插件即生效(注意目录名要和插件 ID 一致,比如 Git 插件必须放在
Git/子目录下) - 这个方法不依赖 Package Control,也不走网络安装流程,但无法自动更新,且部分插件(如依赖二进制组件的)可能缺少构建步骤
真正容易被忽略的是插件名大小写和目录结构——比如 Emmet 插件解压后必须放在 Emmet/ 目录,而不是 emmet/ 或 emmet-master/,否则 Sublime 加载失败且不报错。


















