package control安装成功后ctrl+shift+p搜不到install package，是因为st4默认不自动拉取远程包列表，必须先执行package control: synchronize packages完成同步，再执行install package才会触发fetching list。
Package Control 安装成功后，Ctrl+Shift+P 搜不到 Install Package 怎么办？
不是插件没装上，而是远程仓库索引还没拉取。ST4 默认不自动同步插件列表，必须手动触发一次同步才能让命令生效。
- 按
Ctrl+Shift+P（macOS 用Cmd+Shift+P），输入Package Control: Synchronize Packages回车，等右下角状态栏出现Syncing packages...再到Done - 同步完成后，再输
Package Control: Install Package，状态栏应立刻显示Fetching list of available packages - 如果仍卡住，检查是否被公司/校园网拦截——换手机热点重试最有效
- 别信菜单里多出的
Preferences → Package Settings → Package Control，那是旧版残留；真正标志是命令面板能补全并执行
Package Control: Install Package 执行后列表为空，或搜不到想装的插件
常见于首次使用或网络不稳定时，远程包列表未缓存或加载失败。
- 先确认已成功执行过
Package Control: Synchronize Packages（不是只装完就完事） - 搜插件名时注意大小写和空格：
ChineseLocalizations不是chinese localization，Emmet不是emmet plugin - 某些插件（如
SideBarEnhancements）在 ST4 中需手动启用：安装后重启，再进Preferences → Package Settings → SideBarEnhancements → Settings – User粘贴默认配置 - 若列表始终为空，打开控制台（
Ctrl+`），执行sublime.log_commands(True)，再触发一次Install Package，看日志里是否有http请求失败或timeout
手动安装插件（比如离线环境或官网插件失效）怎么操作？
Package Control 本身不支持“拖 zip 进 Packages 目录”这种老办法，必须走 .sublime-package 文件路径机制，否则命令面板会卡死或功能缺失。
- 插件文件必须是官方发布的
.sublime-package格式（不是解压后的文件夹，也不是.zip） - 路径必须严格为：
Installed Packages/目录（不是Packages/！两者平级） - 查真实路径：控制台执行
sublime.installed_packages_path()，返回值才是你该去的目录（ST4 默认是Sublime Text/Installed Packages） - 扔进去后必须完全退出 Sublime Text（不是关闭窗口），再重新启动，否则加载器不会扫描新文件
装完插件没反应、快捷键不生效、菜单不出现？
多数情况是插件依赖项缺失或配置未激活，而非安装失败。
- 部分插件（如
SublimeLinter或ESLint）需要额外安装系统级工具（Node.js、python-lint 等），仅装插件不等于能用 - 检查插件文档是否要求修改
Settings – User，比如Theme - One Dark必须手动设"theme": "One Dark.sublime-theme" - 冲突常见于多个主题/语法高亮插件同时启用，可临时禁用其他插件测试：
Package Control: Disable Package - ST4 对 Python API 有兼容性调整，某些 ST3 插件已废弃（如老版
Alignment），优先搜 GitHub 上标ST4的 fork 版本
真正卡住的地方从来不是“怎么点”，而是“同步没做”“路径搞错”“文件格式不对”“依赖没配”。四者漏一，插件就停在“看起来装好了”的假象里。
