Package Control 安装失败需依次排查：粘贴脚本含不可见字符、网络拦截致空响应、ST4 使用了ST3旧哈希值（应改用以6f4c264a开头的最新脚本）；若仍无效，手动下载.sublime-package文件放入Installed Packages目录并重启。
Package Control 控制台安装失败怎么办
控制台粘贴脚本后没反应、报 ImportError: No module named 'package_control'，或者执行完显示 Success! 但后续命令面板里搜不到 Package Control: Install Package——这说明安装没真正生效。
常见原因有三个：复制时带了不可见 Unicode 字符（尤其从网页或微信粘贴）、网络被拦截导致 urllib.request.urlopen 返回空响应、ST4 用了 ST3 的旧哈希值脚本（比如以 7183a2d3 开头）。
- 先清空控制台，手动敲
import urllib.request回车，确认基础模块可用 - 再执行官网最新脚本（截至 2026 年 8 月，ST4 应使用以
6f4c264a开头的哈希值） - 若仍失败，直接去
https://packagecontrol.io/Package%20Control.sublime-package下载文件，扔进sublime.installed_packages_path()返回的路径（Windows 默认是%APPDATA%\Sublime Text\Installed Packages\）
插件手动安装路径必须严格区分两类目录
插件不是随便丢进某个文件夹就能用。Sublime 区分 Installed Packages/ 和 Packages/，放错位置等于白装。
.sublime-package 文件（如 Emmet.sublime-package）必须放进 Installed Packages/；而解压后的文件夹（如 Emmet/）必须整个拖进 Packages/，不能嵌套在子目录里，也不能混放。
- 查路径：按
Ctrl+Shift+P输入Preferences: Browse Packages，打开的就是Packages/ -
Installed Packages/路径需手动拼：把Packages/上一级的Installed Packages替换过去 - 装完重启编辑器，否则新插件不会加载
插件装完不生效？先看右下角语法标识和 ignored_packages
装了 Vue Syntax Highlight 却在 .vue 文件里没高亮，大概率不是插件问题，而是作用域没匹配上。
右下角状态栏显示的语法名称（如 Plain Text）就是当前作用域。插件只对特定 selector 生效，比如 text.html.vue 或 source.python。
- 手动切换语法：按
Ctrl+Shift+P输入Set Syntax: Vue看是否立刻变化 - 检查用户设置里
"ignored_packages"数组，确认没把插件名写进去（大小写敏感，"Emmet"和"emmet"不同） - 某些插件依赖其他插件，比如
AutoFileName需要SideBarEnhancements提供的 API，缺一不可
Build System 配置中 shell_cmd 路径斜杠和引号容易出错
Windows 用户写 shell_cmd 时用反斜杠 \ 或没加引号，会导致 g++ 找不到源文件路径里的空格或中文，报 No such file or directory。
macOS/Linux 用户若用 cmd 字段而非 shell_cmd，且没设 "shell": true，变量替换（如 $file）会失效。
- 统一用正斜杠
/，哪怕在 Windows 上也写"g++ \"$file\" -o \"$file_base_name.exe\"" - 所有含变量的路径必须用双引号包裹，避免空格截断
- 调试方法：在
shell_cmd前加echo，比如"echo \"$file\""，看输出是否符合预期
真正卡住人的从来不是“插件装没装”，而是路径权限、作用域匹配、变量展开这些底层细节。它们不报错，只静默失效，得一个个亲手验证才踏实。
