package control安装失败需先验证命令面板能否调出install package并正常加载列表；网络问题可换热点解决；st4必须用含sha256校验的新版脚本；残留文件、ignored_packages、路径错误、大小写敏感及配置位置错误是插件不生效主因。
Package Control装不上？先确认是不是真失败
Sublime Text 启动后没有 Preferences → Package Control 菜单项，不等于安装失败；真正有效的判断依据只有两个：Ctrl+Shift+P（Win/Linux）或 Cmd+Shift+P（macOS）调出命令面板后，输入 Package Control: Install Package 能触发左下角出现 Fetching list of available packages，且不报错、不卡死。
- 如果控制台只显示
reloading plugin就停住，大概率是网络问题——packagecontrol.io在国内常被 DNS 污染或 TLS 握手失败，换手机热点重试最有效 - ST4 用户别用老脚本，必须用带
hashlib.sha256校验的最新版安装代码，否则即使“Success!”提示出现，后续也无法联网加载插件列表 - 已安装但命令面板搜不到
Install Package？进Installed Packages/目录删掉所有含Package Control字样的文件，再重装——旧残留会劫持命令通道
插件装了却没反应？检查作用域、路径和忽略列表
插件不是放进目录就自动工作，它依赖语法识别、作用域匹配和配置加载顺序。比如 Vue Syntax Highlight 只在 .vue 文件或 text.html.vue 作用域下生效，打开纯 .html 文件时完全静默。
- 确认当前文件语法：右下角状态栏看是否为对应语言（如 “Vue”），不是就点它手动切换；或按
Ctrl+Shift+P输入Set Syntax: Vue - 检查
ignored_packages：打开Preferences → Settings，右侧用户配置里若有"ignored_packages": ["Emmet"]这类项，刚放进去的插件名在里面就会被直接屏蔽 - 路径放错是高频问题：下载的是
Emmet.sublime-package→ 必须扔进Installed Packages/；下载的是 ZIP 解压后的Emmet/文件夹 → 必须整体拖进Packages/（不是子目录！）
手动安装插件时，.sublime-package 和源码文件夹怎么选？
两者本质不同：.sublime-package 是 zip 打包的二进制分发格式，由 Sublime 自动解压加载；源码文件夹则是可调试、可修改的开发形态。选择取决于你是否需要定制或排查问题。
- 日常使用优先选
.sublime-package：下载后直接丢进Installed Packages/，重启即用，更新也只需替换文件 - 要改插件行为或调试，必须用源码文件夹：解压 ZIP 后重命名为简洁名（如
ConvertToUTF8，不能留-master），整个文件夹放入Packages/ - 注意大小写敏感：Sublime 加载时严格匹配文件夹名，
emmet和Emmet是两个不同插件；PyV8必须首字母大写，否则依赖失败报ImportError: No module named 'PyV8'
配置改在哪？为什么一升级就还原？
所有用户级配置必须写在 Packages/User/ 下的同名 .sublime-settings 文件里，这是 Package Control 的硬性约定。写在插件自身目录里的配置，升级时会被覆盖，且不会生效。
- 想改
Emmet的缩写行为？新建Packages/User/Emmet.sublime-settings，内容只写你要覆盖的键值对，例如：{"abbreviations": {"div": "<div class='\"${1}\"'>${2}</div>"}} - 拼错键名（如把
enable_tab_expand写成tab_expand_enable）或类型错误（该写true写成"true"）会导致静默忽略，控制台无任何提示 - 插件自带的默认配置在
Packages/插件名/插件名.sublime-settings，仅供查阅，切勿编辑
ignored_packages 和 Packages/User/ 配置位置——这两个地方查一遍，80% 的“不生效”问题就解决了。
