Package Control 卡在“Installing 1 package”主因是 packagecontrol.io 国内访问受限,导致索引和插件下载超时;手动安装需将 GitHub 下载的 ZIP 解压重命名后拖入 Packages 目录并彻底重启 Sublime。

为什么 Package Control 下载插件总卡在 “Installing 1 package”?
这不是你网络差,而是 Package Control 默认从 packagecontrol.io 拉取插件索引和 .sublime-package 文件,该域名在国内常被限速或 DNS 解析缓慢,导致命令面板里一直转圈、超时失败,甚至报错 Unable to download … timeout。
手动安装插件的三步实操(跳过网络瓶颈)
本质是绕过 Package Control 的在线分发链路,直接把插件文件放进 Sublime 的插件目录。关键不是“复制粘贴”,而是路径、命名和重启时机要对:
- 去插件 GitHub 主页(比如
https://github.com/facelessuser/BracketHighlighter),点Code → Download ZIP,不要用git clone(可能含 submodule 或 build 脚本,Sublime 不认) -
解压 ZIP 后,把整个文件夹重命名为干净名称(如把
BracketHighlighter-master改成BracketHighlighter),确保不含空格、中文或特殊符号 - 打开 Sublime →
Preferences → Browse Packages…,把重命名后的文件夹拖进弹出的Packages目录(不是Installed Packages!) - 关闭并彻底退出 Sublime(macOS 注意右键 Dock 图标选
Quit,Windows 检查任务栏后台进程),再重新启动
遇到“插件不生效”先查这三件事
手动装完却没反应?90% 是下面某个环节出了问题:
-
Packages目录放错位置:确认你进的是Preferences → Browse Packages…打开的路径,不是 Sublime 安装目录,也不是Cache或Index文件夹 - 插件依赖未满足:比如
Python Lint需系统已装pylint,Emmet在 Sublime Text 4 中需启用emmet-sublime分支(不是旧版emmet) - 插件本身不兼容当前版本:Sublime Text 4 已弃用 Python 2 插件,若插件仓库最后更新是 2018 年前、且无
python3标签,大概率无法加载——可看控制台(Ctrl + `)是否有ImportError或invalid syntax
更省事的替代方案:用 .sublime-package 文件直装
有些插件作者会发布编译好的 .sublime-package 文件(单个二进制包,非源码),它比手动解压 ZIP 更轻量,也避免命名/结构错误:
- 在插件 GitHub 的
Releases页面找带.sublime-package后缀的附件(如SideBarEnhancements.sublime-package) - 下载后,直接丢进
Packages目录(不是子文件夹!就放在Packages根下) - 重启 Sublime,它会自动解压并启用——这个过程不可逆,卸载时需手动删该文件
注意:.sublime-package 文件不能重命名(必须保持原名),也不能放进子文件夹,否则 Sublime 完全无视。










