package control是sublime text 4的包管理框架而非插件；st4必须用哈希以6f4c264a开头或官方installation.py脚本安装，失败则手动将package control.sublime-package拖入installed packages/并重启，验证标准为ctrl+shift+p执行package control: list packages能返回列表。
Sublime Text 本身不带插件管理能力，所有扩展功能都依赖 Package Control —— 它不是“一个插件”，而是整个插件生态的运行基础。没装好或装错版本（比如 ST4 用了 ST3 的旧脚本），Ctrl+Shift+P 里根本不会出现 Install Package 命令，后续所有操作都是空转。
确认 Sublime Text 版本再动手
别凭记忆或菜单名判断。打开 Help → About Sublime Text，顶部明确显示【Sublime Text 4】才算 ST4。2026 年绝大多数用户用的是 ST4，但网上大量教程仍混用 ST3 脚本，哈希值（h）和下载地址都不兼容。
- ST4 必须用哈希以
6f4c264a开头的脚本，或直接执行官方installation.py - 如果控制台执行后左下角没弹出
Package Control: Successfully installed Package Control，就不是真成功 - 菜单里有
Package Control选项 ≠ 能联网、能列包、能安装 —— 唯一硬指标是：Ctrl+Shift+P输入Package Control: List Packages能执行并返回结果
安装 Package Control 的两种可靠路径
网络通畅时走控制台一键执行；被墙、代理或 SSL 报错时，必须手动。
- 控制台方式（推荐先试）：
Ctrl+`→ 粘贴完整脚本：import urllib.request,os,hashlib; exec(urllib.request.urlopen('https://packagecontrol.io/installation.py').read().decode('utf-8'))→ 等满 5 秒看弹窗 - 手动方式（失败后立即切）：关闭 Sublime → Preferences → Browse Packages… → 关闭窗口，上一级就是
Installed Packages/→ 下载https://packagecontrol.io/Package%20Control.sublime-package→ 拖入该目录（不要解压、不要改名、不要放错目录）→ 重启 - 若之前装过旧版，先清空
Installed Packages/中所有含Package Control字样的文件，否则会静默劫持命令通道
用 Package Control 安装常用插件的实际要点
Ctrl+Shift+P 输入 Package Control: Install Package 后，搜索框出现才真正进入插件安装流程。常见插件如 Emmet、SideBarEnhancements、BracketHighlighter 都走这条路，但要注意：
- 搜索时输全名更稳，比如
SideBarEnhancements（不是Sidebar或Enhancement） - 安装过程无进度条，只看左下角状态栏从
=晃动到消失，然后弹出successfully installed提示 - 插件是否生效，看 Preferences → Package Settings 里有没有对应条目，而不是菜单里有没有新选项
- 某些插件（如
HTML-CSS-JS Prettify）依赖 Node.js，装完还得确保系统 PATH 里有node命令，否则格式化会报Node binary not found
代码片段同步不是开箱即用的功能
所谓“一键同步代码片段”，实际靠的是 Sync Settings 插件把 Packages/User/ 下的 .sublime-snippet 文件上传到 GitHub Gist。它不自动扫描、不识别乱放的 snippet。
- 你的自定义 snippet 必须严格放在
Packages/User/xxx.sublime-snippet，放错路径（比如丢进Data/根目录）等于不存在 -
Sync Settings默认只同步Settings、Key Bindings、snippets、packages四类，color schemes等需在插件设置里手动勾选 - 首次同步前，必须去 GitHub 创建
Personal Access Token（至少勾选gist权限），填进Sync Settings配置，否则上传直接失败，错误是Gist ID not found
最常被忽略的一点：所有插件行为都建立在 Package Control 正确加载的基础上，而它的加载又依赖于 Sublime Text 启动时对 Installed Packages/ 目录的扫描顺序。如果你手动拖过插件 ZIP 进 Packages/ 目录，又没重启，或者同时存在同名插件的 ZIP 和文件夹，就会导致部分功能加载失败且无提示。
