Sublime Text 本身不自带插件管理能力，所有插件都依赖 Package Control 框架；没装对 Package Control，后续安装均为无效操作——仅当 Ctrl+Shift+P 可执行 Package Control: List Packages 和 Install Package 且无报错，才视为真正生效；ST4 用户必须使用官网 installation.py 脚本或手动将 Package Control.sublime-package 拖入 Installed Packages/ 目录，旧脚本静默失效。
Sublime Text 本身不自带插件管理能力，所有插件都依赖 Package Control 框架；没装对 Package Control，后面装任何插件都是假动作——命令面板里搜不到、右键菜单不出现、快捷键没反应，全是它没真正跑起来的表象。
Package Control 装没装好，只看两个动作
别信菜单里有没有“Package Control”字样，只认这两件事是否成功：
- 按
Ctrl+Shift+P（macOS 是Cmd+Shift+P），输入Package Control: List Packages，能执行并列出一堆已安装包（哪怕只有默认的） - 再输
Package Control: Install Package，能弹出空白搜索框，光标在框里闪烁——不是卡死、不是报错、不是一闪而过
如果任一失败，说明 Package Control 没生效。ST4 用户必须用官网 installation.py 脚本或手动拖入 Package Control.sublime-package 到 Installed Packages/ 目录，旧版脚本在 ST4 上大概率静默失效。
Debugger 插件装了但 Debug 菜单不出现？重启是硬门槛
Debugger 插件（rprichard 维护的蓝色靶心图标那个）安装后，Debug 菜单项不会立刻出现——必须重启 Sublime Text。常见误操作是点完 Install 就去点 Tools → Debug，结果菜单里压根没这一项。
- 重启后仍无
Debug菜单，打开控制台（Ctrl+`），输入sublime.log_commands(True)，再按Ctrl+Shift+P搜Debug，看命令是否被识别；没输出就说明插件根本没加载 - 确认插件状态：
Package Control: List Packages里要能看到Debugger（不是SublimeDebugger或Xdebug Client） - Windows 用户若用中文输入法，
Ctrl+Shift+P可能被切换中英文快捷键劫持，临时切英文再试
SVG Viewer 点了没反应？先盯住右下角语法标识
“点了预览没反应”90% 不是插件问题，而是 Sublime 根本没把文件当 SVG 解析。窗口右下角状态栏必须显示 SVG，不是 XML、不是 Plain Text、更不能是空白。
- 右键文件 →
Open all with current extension as…→ 选SVG；如果列表里没有 SVG，说明插件没注册语法高亮，重装 SVG Viewer 后重启 - 检查文件扩展名：Windows 可能显示
.SVG（大写），但 Sublime 默认只认小写.svg；改后缀再试 - 路径含空格或中文？构建系统方式比插件更稳：新建 Build System，
shell_cmd直接写start chrome "$file"（Win）或open -a "Google Chrome" "$file"（macOS）
Build System 编译 C++ 报 “g++ not found”？PATH 和 shell_cmd 要对齐
编译失败时控制台报 'g++' is not recognized（Windows）或 command not found: g++（macOS/Linux），说明 Sublime 没继承系统 PATH，或者 shell_cmd 写法和实际终端行为不一致。
- 先在系统终端里运行
g++ --version，确认能返回版本号；不能就说明 MinGW/MSYS2/GCC 没装好或 PATH 没设对 - Build System 的
shell_cmd中，Windows 用cmd /c g++ ...，macOS/Linux 用bash -c "g++ ..."；直接写g++在某些环境下会找不到命令 -
"$file"必须加双引号，否则路径含空格时编译直接崩；-std=c++17这类参数别漏掉，否则可能因语法报错
调试配置里 program 和 cwd 错一位，断点就全失效；SVG 文件里 viewBox 少一个数字，浏览器预览就是白屏——这些细节不靠猜，得盯着错误源头看状态栏、控制台、终端输出三处反馈，才能真正闭环。
