package control未安装或未加载成功时,install package命令不会出现在命令面板中;需先确认sublime版本,执行对应官方安装脚本并重启,再检查installed packages/路径下文件是否正确写入且无残留。

Package Control 没装上,或者装了但没加载成功——Install Package 命令根本不会出现在命令面板里。这不是网络问题,是 Sublime 启动时压根没识别到 Package Control。别急着换源、配代理,先确认它是否存在、是否被正确写入。
按 Ctrl+Shift+P 搜不到 Install Package,说明 Package Control 未安装或损坏
这是最基础的判断点:命令面板里连 Package Control 四个字都搜不到,就代表底层缺失。不是插件列表为空,是管理器本身没跑起来。
- 打开 Sublime → 菜单栏 Help → About Sublime Text,确认版本是
Sublime Text 4(Build ≥ 4126)还是Sublime Text 3;两者安装脚本不兼容,用错直接静默失败 - 按
Ctrl+`(反引号)呼出控制台,手动执行对应版本的官方安装代码(不是网页上随便抄的旧脚本) - 执行后控制台末尾必须出现
Success或写入路径日志;如果只闪一下、没输出、或报ModuleNotFoundError: No module named 'urllib.request',说明脚本和版本不匹配 - 装完必须重启 Sublime,否则
Preferences → Package Control菜单项也不会出现
Package Control.sublime-package 文件存在但命令仍不显示
文件在 Installed Packages/ 目录下,不代表它已被 Sublime 正确解压加载。常见于解压失败、权限异常或被其他插件阻塞。
- 关闭 Sublime,进
Installed Packages/目录,删掉Package Control.sublime-package - 同时检查
Packages/目录下是否有残留的Package Control/文件夹,有就一并删掉 - 重新打开 Sublime,再执行一次控制台安装脚本(确保用对版本),看到
Success后重启 - 若仍无效,可临时禁用所有第三方插件:
Preferences → Package Control → Disable Package,选全部禁用,再逐个启用排查
装上了却卡在“There are no packages available”
这表示 Package Control 已运行,但拿不到插件索引——本质是 channels 地址不可达,不是插件源本身坏了。
- 打开
Preferences → Package Settings → Package Control → Settings – User,确认"channels"是一个数组,且内容为可用的 v3 JSON 地址,例如:"https://gitee.com/azl397985856/package_control_channel/raw/master/channel_v3.json" - 把该 URL 粘到浏览器地址栏访问,能返回 JSON 内容才算有效;打不开就换镜像,别硬等
- 改完配置必须重启 Sublime,不重启配置不生效
- 如果控制台报
schema_version mismatch,说明你混用了 v2 channel 和新版 Package Control,必须统一用 v3 地址
手动安装插件时命名和路径必须严格匹配
离线或网络受限环境下,手动安装是最可控的方式,但错一个字符就会让插件“装上了却用不了”。
- 去
https://packagecontrol.io或 Gitee 镜像页搜插件名,下载 ZIP 包(不是 GitHub 页面的 “Code → Download ZIP”,那是仓库源码) - 解压后得到的文件夹名必须和插件名完全一致,比如插件叫
SideBarEnhancements,文件夹就不能叫SideBarEnhancements-master - 复制该文件夹到
Packages/目录(不是Installed Packages/),路径应为:Packages/SideBarEnhancements/ - 重启 Sublime,再查命令面板或快捷键是否生效;如果仍不响应,检查
Preferences → Settings – User里的"ignored_packages"是否误列了该插件名
最容易被忽略的是:装完 Package Control 后不重启,或改了 channels 不重启,或手动放插件时多了一层目录。这些操作看似微小,但 Sublime 的加载机制对路径和时机极其敏感,跳过任何一步都会导致“看起来装好了,实际没反应”。











