package control未安装成功导致插件无法安装，因其是sublime text的底层包管理框架而非普通插件；st4用户必须使用以6f4c264a开头的官方脚本或手动将package control.sublime-package拖入installed packages/目录并重启验证。
Package Control 没装上，插件根本装不了
Sublime Text 本身不带插件管理能力，Package Control 不是插件，而是底层包管理框架——没它，Ctrl+Shift+P 里搜不到 Install Package，所有“下一步安装插件”的操作都卡死在第一步。
常见错误现象：Preferences → Package Control 菜单项存在，但点开无响应；或命令面板能搜到 Package Control: Install Package，回车后只显示“Loading packages”然后消失，无列表弹出。
- 必须先确认 Sublime 版本：Help → About Sublime Text，看清楚是
Sublime Text 4还是Sublime Text 3——2026 年绝大多数用户用的是 ST4，旧版脚本（含urllib2、SHA1 校验、sublime.wbond.net域名）会静默失败 - ST4 唯一可靠安装方式只有两个：
import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8'))（控制台执行），或手动下载Package Control.sublime-package文件拖入Installed Packages/目录（不是Packages/） - 手动安装前务必清空
Installed Packages/中所有含Package Control字样的文件，残留旧包会导致命令通道被劫持 - 验证是否真生效：按
Ctrl+Shift+P→ 输入Package Control: List Packages，能列出已装包（哪怕为空）才算成功
Install Package 命令执行后没反应？网络或证书拦住了
Package Control: Install Package 执行后卡在 “Loading packages”，大概率不是你操作错，而是网络层出了问题——ST4 默认走 HTTPS 请求仓库元数据，国内部分环境会因证书校验失败或 DNS 污染直接超时，控制台也不报错。
典型表现：状态栏短暂显示 “Loading packages”，几秒后归零，命令面板退回空白状态，Ctrl+` 控制台无任何输出。
- 别反复重试，重试只会加重缓存混乱；直接切手动方式：关闭 Sublime → 下载
https://packagecontrol.io/Package%20Control.sublime-package→ 拖进Installed Packages/→ 重启 - Windows 用户注意权限：如果 Sublime 是以管理员身份运行过，后续普通用户模式下写入
Installed Packages/可能被系统拦截，导致文件看似写入实则无效 - Mac/Linux 用户若用 Homebrew 安装的 ST，
installed_packages_path()返回路径可能在~/Library/Application Support/Sublime Text/Installed Packages/，别错放到~/Library/Application Support/Sublime Text/Packages/
插件装上了但没效果？配置才是关键一步
很多插件（比如 StatusBarEnhanced、SideBarEnhancements）安装完默认不启用任何功能，不改配置就等于白装。它们不像 IDE 那样“开箱即用”，而是把控制权交给你。
常见错误现象：插件出现在 Package Control: List Packages 列表里，但右键没新菜单、状态栏仍是空的、快捷键不起作用。
- 必须打开
Preferences → Package Settings → [插件名] → Settings，编辑右侧用户配置文件（不是左侧默认配置） - 例如
StatusBarEnhanced至少要写一个"items"数组：[{"type":"encoding","format":"ENC: {value}"}]，缺"type"或值非法（如写成"file_encoding"而非"encoding"），整条会被忽略 - Git 相关字段（如
"git_branch"）只对当前文件所在路径是 Git 仓库根目录才生效；子目录下文件可能检测不到分支，这不是插件 bug，是设计如此 - 部分插件依赖其他插件（如某些 LSP 客户端需先装
LSP主包），装完主包后还得手动启用服务器，不能只靠安装动作
手动拖包进 Packages/ 目录为什么有时失效
把 ZIP 解压后扔进 Packages/ 看似最直觉，但在 ST4 上极易出问题：API 变更导致旧插件初始化失败、缺少 sublime-package 封装导致加载顺序错乱、或插件自带的 .py 文件因 Python 版本差异（ST4 用 Python 3.8+）直接抛 SyntaxError。
典型症状：插件名出现在 List Packages 里，但命令面板搜不到对应命令；或打开设置时报 Unable to open ... settings；甚至引发整个 Sublime 启动变慢。
- 除非插件明确说明支持手动安装（如文档写了 “Extract to Packages/”），否则一律优先走
Package Control渠道 - 手动安装仅适合调试或离线环境，且必须确认插件仓库的
st4分支或master的最新提交已适配 ST4 API（比如弃用sublime.set_timeout改用sublime.set_timeout_async） - 装完后务必检查控制台：
Ctrl+`里有没有ImportError、AttributeError或invalid syntax报错，有就说明插件代码不兼容
真正麻烦的从来不是“怎么点几下装上”，而是版本匹配、网络穿透、配置激活这三关——任何一个环节断掉，插件就只是个名字而已。尤其 ST4 的 Installed Packages/ 目录权限和旧版逻辑完全不同，靠记忆或复制几年前的教程，大概率白忙活。
