Package Control未装好导致Install Package不可用,需验证List Packages和Install Package能否执行;国内用户应改用GitHub镜像安装并检查配置路径、权限及环境变量。

Package Control没装好,命令面板根本搜不到Install Package
不是快捷键按错了,也不是插件名拼错了——90%的情况是Package Control压根没装成功。Ctrl+Shift+P(Windows/Linux)或Cmd+Shift+P(macOS)调出命令面板后,输入Package Control: Install Package无响应、不出现、或者输完回车没反应,基本可以断定框架缺失。
验证方式只有两个硬指标:Package Control: List Packages能执行并返回列表;Package Control: Install Package能触发“Loading packages”提示。其他任何菜单项、Preferences里的选项、甚至控制台里显示“reloading plugin”,都不算数。
- 重试前先确认Sublime Text版本:Help → About Sublime Text,必须看清是ST3还是ST4,官网脚本不通用
- 控制台执行安装脚本后只显示空行?大概率网络超时或SSL拦截,别反复粘贴,直接切手动安装
- 手动安装时,
Package Control.sublime-package文件必须放进Installed Packages/目录,不是Packages/,放错位置等于没装 - 之前装过旧版?删掉
Installed Packages/里所有带“Package Control”字样的文件,残留会劫持命令通道
Install Package命令能调出但列表空白或加载失败
命令面板能唤出Package Control: Install Package,但等半天卡在“Loading packages”,或者列表为空,说明插件源连不上,不是你本地没网,而是Package Control默认的https://packagecontrol.io/被阻断了。
这时候不能靠重试或换关键词,得改源地址。最稳的方式是进控制台(Ctrl+`),执行以下替换命令:
import urllib.request,os; pf='Package Control.sublime-package'; ipp=sublime.installed_packages_path(); by=urllib.request.urlopen('https://ghproxy.com/https://packagecontrol.io/'+pf.replace(' ','%20')).read(); open(os.path.join(ipp,pf),'wb').write(by)
注意:这段代码绕过了官方域名,直连 GitHub 镜像,适用于国内多数网络环境。
- 如果控制台报
urllib.error.URLError,说明系统级代理没配对,换镜像比配代理更可靠 - Mac 上提示
Permission denied?别用 sudo 启动 Sublime,而是把下载好的Package Control.sublime-package手动拖进~/Library/Application Support/Sublime Text/Packages/Installed Packages/ - 装完仍加载失败?检查
Preferences → Package Settings → Package Control → Settings – User里有没有"ignored_packages"包含"Package Control"
搜到插件但安装后不生效,Terminus这类插件尤其典型
比如装完Terminus,Ctrl+Shift+P里能搜到terminus_open,但快捷键按了没反应,终端面板打不开——这不是插件坏了,是它根本没绑定快捷键,也没配置工作目录。
Terminus装完是“裸奔”状态,默认不占任何快捷键,也不自动切换到当前文件路径。你得手动加 JSON 配置:
[{"keys": ["ctrl+alt+t"], "command": "terminus_open", "args": {"cwd": "${file_path:${folder}}"}}]
这段必须贴进Preferences → Key Bindings右侧的用户配置区,不能写在左侧默认区,也不能漏掉cwd参数。
- 别用
ctrl+`绑定——它默认被 Python 控制台占用,强行覆盖会导致控制台打不开 -
cwd参数值"${file_path:${folder}}"意思是:有打开的文件就用该文件路径,没文件但开了项目就 fallback 到项目根目录 - 装完插件后建议完全退出 Sublime 再重开,否则面板缓存可能卡住,导致
terminus_open命令静默失效 - 如果控制台报
ImportError: No module named terminus,删掉Packages/Terminus/整个目录重装,别从 GitHub clone
终端插件里找不到 git/python/node,别怪插件
Terminus 打开后执行git --version报 command not found,或者python进不去交互环境,这不是插件问题,是你系统 shell 没加载环境变量。
Terminus 调用的是你系统的bash、zsh或powershell.exe,但它默认以非 login 模式启动,不会读取~/.zshrc或~/.bashrc,PATH 里你手动加的路径全失效。
- Mac / Linux 用户:在 Terminus 配置里加
"shell": "zsh -l"或"shell": "bash -l",-l表示 login 模式,强制加载配置文件 - Windows 用户:用
powershell.exe -ExecutionPolicy ByPass确保策略不拦截 - 别指望插件自动修复 PATH——它只是个终端外壳,背后 shell 的初始化逻辑你得自己管
真正卡住人的从来不是“怎么点菜单”,而是装完插件后发现快捷键没绑、终端找不到命令、或者列表加载不出来却不知道该查哪一层。每一步都有明确的验证点和绕过方案,而不是反复重启或重装。











