必须先安装Package Control,因为它是Sublime Text唯一的官方推荐插件管理器,提供索引拉取、依赖处理、自动更新等功能;手动安装不可靠且不支持升级。

Sublime Text 安装扩展(即插件)的核心路径只有一条:必须先装 Package Control,否则所有「一键安装」都走不通。手动放包进 Packages 目录虽可行,但无法自动更新、容易路径错乱、不支持依赖管理——实际开发中不推荐。
为什么必须先装 Package Control?
Sublime Text 本身不带插件市场,Package Control 是社区维护的第三方包管理器,它负责:拉取插件仓库索引、校验哈希、解压安装、处理依赖、提供升级入口。没它,Ctrl+Shift+P → Install Package 这个命令根本不存在。
- 控制台安装最稳:按
Ctrl + `(反引号)调出控制台,粘贴官方 Python 安装脚本(注意核对 Sublime Text 3/4 对应的哈希值h = '6f4c264a24d23ca7df454c82994c8f2d' + 'e') - 别信“菜单里点 Install Package Control”——这个选项在较新版本中已移除,强行点会报错
command not found: package_control_install - 安装后必须重启 Sublime Text,否则菜单栏不会出现
Package Control项,命令面板也搜不到相关指令
Install Package 命令没反应或卡在 Loading Repositories
这是网络问题导致插件仓库列表拉不下来,不是插件本身故障。默认源 https://packagecontrol.io/ 在国内常被干扰。
- 临时解决:用代理(需 Sublime 支持 HTTP 代理配置),或改用国内镜像源(如清华源),修改
Package Control.sublime-settings中的channels字段为["https://mirrors.tuna.tsinghua.edu.cn/packagecontrol/channel.json"] - 验证是否生效:打开命令面板
Ctrl + Shift + P,输入Package Control: List Packages,能列出已装插件说明通道通了;若仍卡住,检查系统时间是否准确(TLS 握手失败会导致静默失败) - 别反复重试 Install Package —— 多次失败会在
Cache/Package Control/下堆积临时文件,可手动清空该目录再试
装完插件没效果?重点查这三处
很多用户以为装完就自动启用,其实多数插件需要显式触发或配置才能工作。
-
Emmet:装完后需在 HTML/CSS 文件中输入缩写(如div.container)再按Tab,纯文本文件里无效 -
SideBarEnhancements:右键资源管理器(侧边栏)才出现「Open in Terminal」「Copy Path」等菜单,编辑区右键无变化 -
BracketHighlighter:默认只高亮括号,要开启标签匹配需在Preferences → Package Settings → BracketHighlighter → Bracket Settings中把"tag_mode": true打开 - 所有插件设置都在
Preferences → Package Settings下,名称不对或路径为空,大概率是插件没真正加载成功(可看 Sublime 底部状态栏是否显示插件名)
手动安装插件的适用场景和风险
仅当 Package Control 完全不可用(如离线环境、公司防火墙彻底封锁)时才考虑手动方式,且必须严格遵循路径规则。
- 路径必须精准:通过
Preferences → Browse Packages…打开的目录才是有效Packages,不是安装目录下的那个Packages - 解压后文件夹名不能带版本号或
-master后缀,比如下载的是Emmet-master.zip,解压出来要重命名为Emmet文件夹再放入 - 手动装的插件不会出现在
Package Control: List Packages列表里,也无法用Package Control: Remove Package卸载,只能手动删文件夹 - 如果插件含
.py文件但依赖其他库(如requests),手动安装大概率报ImportError——Sublime 的 Python 环境不自带第三方包
最易被忽略的一点:插件行为高度依赖当前文件的语法类型(syntax)。比如 Python Lint 只在 source.python 作用域下运行,你用纯文本模式打开 .py 文件,它就完全静默。务必检查右下角显示的语法名,必要时手动选 View → Syntax → Python。


















