Package Control 必须正确安装才能使用插件:确认是 ST4 并用官网脚本或手动安装,清空旧残留,验证命令可执行且网络通畅;第三方库需解压至 Packages/ 根目录,大小写与架构须匹配;插件生效需语法绑定正确且路径无误。

Package Control 没装好,后面所有插件和第三方库都白搭——它不是插件,是 Sublime Text 4 的包管理框架,控制台执行脚本失败、命令面板里搜不到 Install Package、或者点了没反应,基本都是它没真正通路。
确认 Sublime Text 版本再动手
别凭印象猜。打开 Help → About Sublime Text,顶部显示的是 Sublime Text 4 还是 Sublime Text 3?2026 年绝大多数人用的是 ST4,但网上大量旧教程贴的 ST3 脚本(哈希值以 2915d185 开头),直接粘过去会静默失效:控制台显示 Success!,可 Ctrl+Shift+P 里就是没有 Install Package 命令。
- ST4 必须用官网动态生成的脚本,当前(2026 年 8 月)有效地址是:
https://packagecontrol.io/installation.py - 手动安装更稳:关掉 Sublime → Preferences → Browse Packages… → 上一级进
Installed Packages/目录 → 下载Package Control.sublime-package文件(注意 URL 里有空格编码%20,别手改)→ 直接拖进去 → 重启 - 装之前清空
Installed Packages/里所有带Package Control字样的文件,旧残留会劫持命令通道
Package Control: Install Package 没反应?先验证通路
菜单里有 Package Control 选项 ≠ 它能联网、能拉列表。真生效只看两个动作:
- 按
Ctrl+Shift+P输入Package Control: List Packages→ 能执行并返回空列表(不是报错) - 输入
Package Control: Install Package→ 左下角出现Fetching list of available packages... - 如果卡在
reloading plugin或完全没反应,大概率是网络被拦:公司/校园网常屏蔽packagecontrol.io,换手机热点最直接 - 控制台里试这行:
urllib.request.urlopen('https://packagecontrol.io/').getcode(),返回200才算通
“第三方库”不是 pip install,得放对位置
Sublime Text 不走系统 Python 环境,插件里 import requests 报错,不是你没装 requests,而是它根本找不到。所谓“安装第三方库”,实际是把模块文件夹整个扔进 Sublime 的 Packages/ 目录根路径:
- 必须解压到
Packages/requests/(含__init__.py),不能放Installed Packages/,也不能嵌套进Packages/MyPlugin/ - 大小写敏感:
PyV8≠pyv8,错一个字母就静默失败 - 含二进制的库(如
PyV8.pyd)必须匹配你的系统架构(win64 / macOS arm64 / linux x64)和 Sublime 版本(ST4 的 PyV8 和 ST3 不兼容) - 构建系统调用 CLI 工具(比如
black)是另一回事:别依赖PATH,写绝对路径,例如"cmd": ["/opt/homebrew/bin/black", "$file"]
装完插件却没效果?先看右下角语法标识
插件不是复制进去就自动工作。很多插件(比如 Vue Syntax Highlight)只在特定语法作用域下激活:
- 右下角状态栏显示的是
HTML还是Vue?如果是.vue文件但显示HTML,说明语法没绑定上 - 手动切换:
Ctrl+Shift+P→ 输入Set Syntax: Vue,立刻看高亮是否变化 - 路径放错是高频问题:
Emmet.sublime-package得扔进Installed Packages/;而解压后的Emmet/文件夹必须整体拖进Packages/根目录 - 检查配置:
Preferences → Settings右侧用户设置里,"ignored_packages"数组是否误写了插件名(比如"Emmet")

















