Sublime插件装不上、不生效或手动安装无反应，90%因路径错误或ignored_packages拦截；必须通过Preferences→Browse Packages…确认真实目录，.sublime-package放Installed Packages/，源码文件夹放Packages/根目录，且需重启并检查ignored_packages配置。
Sublime 插件装不上、装了不生效、手动放进去却没反应——90% 是路径放错或 ignored_packages 拦截，不是插件坏了，也不是你操作错了，是 Sublime 的加载机制在 quietly 跳过它。
Preferences → Browse Packages… 是唯一可信路径
别记路径，也别猜。Windows 的 %APPDATA%\Sublime Text\Packages、macOS 的 ~/Library/Application Support/Sublime Text/Packages、Linux 的 ~/.config/sublime-text\Packages 都只是默认值，一旦启用便携模式、自定义 data 目录、或迁移过配置，就立刻失效。
-
Preferences → Browse Packages…菜单项永远指向当前生效的真实目录，无论 ST3/ST4、系统版本、安装方式（Snap/Flatpak/便携版） -
Installed Packages/只存.sublime-package压缩包缓存，不是运行加载位置；往这儿拖文件夹，Sublime 根本不扫描 - 便携版用户：插件目录就在解压根目录下的
Data\Packages - Snap/Flatpak 用户：沙盒隔离导致路径不可见，
Browse Packages…是唯一能打开的入口
.sublime-package 文件和源码文件夹不能混放
Sublime 加载逻辑很明确：压缩包走 Installed Packages/，源码走 Packages/ 顶层目录。放错位置 = 彻底忽略，不报错、不提示、控制台也不打印。
-
Emmet.sublime-package→ 必须放进Installed Packages/ - 解压后的
Emmet/文件夹 → 必须整体放进Packages/（即Packages/Emmet/xxx.py） - GitHub 下载 ZIP 后常多出一层
BracketHighlighter-master，要重命名为BracketHighlighter，不能含空格、中文、点号或特殊符号 - 确保文件夹内至少有一个
.py文件，且定义了继承自sublime_plugin.TextCommand等的类
Package Control 没反应？先验证它是否真通路
菜单里有 “Package Control” 不代表它能用。真正生效的标志只有两个：Package Control: List Packages 返回空列表（不是报错），Package Control: Install Package 触发 Fetching list of available packages。
- 按
Ctrl+Shift+P输入Install Package没反应？先查控制台：View → Show Console，执行urllib.request.urlopen('https://packagecontrol.io/').getcode()，返回200才算通 - 公司/校园网常屏蔽
packagecontrol.io，换手机热点最有效；DNS 污染或 TLS 握手卡住时，控制台只显示reloading plugin就停住 - 检查
Preferences → Package Settings → Package Control → Settings – User中"channels"是否指向可访问的 JSON 地址，比如"https://packagecontrol.io/channel_v3.json" - 旧版残留文件（如
Package Control.sublime-package或Package Control.py）会劫持命令，导致命令面板识别名字却无法执行
插件装完不生效？重点看语法作用域和 ignored_packages
插件不是放进目录就自动工作。它依赖当前文件的语法作用域、用户配置位置、以及是否被显式忽略。
- 右下角状态栏看当前语法——比如
Vue Syntax Highlight只在.vue文件或作用域为text.html.vue时生效；纯.html文件不会触发 - 手动切换语法测试：
Ctrl+Shift+P输入Set Syntax: Vue，看是否立刻高亮 - 检查
Preferences → Settings右侧用户配置中"ignored_packages"数组，确认没把刚装的插件名写进去（例如"Emmet"或"AutoFileName"） - 配置必须写在
Packages/User/下同名.sublime-settings文件中，写在插件自带的默认配置里无效
最常被忽略的是：重启 Sublime ≠ 插件重载。有些插件需要完全退出再启动，有些则需手动执行 sublime_plugin.reload_plugin；而 ImportError: No module named 'some_missing_dep' 这类报错，说明它依赖其他模块（比如 sublime_lib），但你只装了主插件，没装依赖。
