wordhighlight 和 highlightwords 分别实现语法感知自动高亮与手动关键词强制高亮；安装需严格匹配文件夹名和 packages 路径，重启生效；配置依赖 word_separators、作用域及主题颜色规则，调试应先切换 adaptive 主题验证。
WordHighlight 和 HighlightWords 都能实现“双击单词高亮”，但它们解决的是两类不同问题：前者是语法上下文感知的自动高亮，后者是手动指定关键词的强制高亮。装错一个，就等于没装。
WordHighlight 双击不生效？先看文件路径和 word_separators
插件根本没加载，90% 是因为解压后文件夹名不是 WordHighlight，或放错了 Packages 目录。macOS 路径是 ~/Library/Application Support/Sublime Text/Packages/，Windows 是 %APPDATA%\Sublime Text\Packages\，Linux 是 ~/.config/sublime-text/Packages/。装完必须重启 Sublime。
重启后双击 user_id 没反应？默认 word_separators 包含下划线，user_id 会被切分成两个词。打开 Preferences → Settings – Syntax Specific（确保当前是 Python 或 JS 文件），在右侧加：
"word_separators":"./\()\"'-:,.;~!@#$%^&*|+=[]{}`? "
这个改动会影响所有双击选中行为，不只是高亮。
- 想让高亮进字符串和注释，得改
WordHighlight.sublime-settings：设"word_highlight_in_comments": true，并清空"ignore_scope_list" - 高亮颜色看不见？右键 →
Developer → Show Scope Name，如果末尾不是wordhighlight，说明作用域没命中；如果是，说明当前主题没定义wordhighlightscope
HighlightWords 加词后不亮？关掉原生 highlight_word 再试
Sublime 原生的 highlight_word 和 HighlightWords 在 ST4 下会互相压制。打开 Preferences → Settings，确认用户设置里没有 "highlight_word": true —— 有就删掉或设为 false。
加词不能写配置，必须走命令面板：Ctrl+Shift+P → HighlightWords: Add Word，输入 \bTODO\b 或 ERROR|WARN 都支持正则。加完立刻生效，但只在当前语法上下文中匹配（比如在 JS 文件里加的词，不会在 CSS 文件里亮）。
- 全局高亮干扰开发？进
Preferences → Package Settings → HighlightWords → Settings，加"global_highlight": false - 如果用了
BracketHighlighter或SideBarEnhancements，临时禁用它们，排除冲突 - 命令面板搜不到
HighlightWords？必须输全名，Highlighter、WordHighlight、HighlightWord都不对
ColorHighlighter 颜色块不显示？检查语法识别和 theme scope
插件名必须是 ColorHighlighter（结尾带 r），搜 ColorHighlight 或 Color Highlight 都装不上。装完后右下角语法名要是 CSS、HTML、Vue Component 或 JavaScript (Babel) 才会启动；Plain Text 或 JSON 下直接不干活。
JS 字符串里的 "#3498db" 不亮？默认关闭字符串内匹配。打开 Preferences → Package Settings → ColorHighlighter → Settings - User，写入：
{"color_highlight_in_strings": true}
保存后按 Ctrl+Shift+P → Color Highlighter: Highlight 刷新缓存，不用重启。
- 颜色块偏淡或错位？右键 →
Show Scope Name，看是不是color_highlighter；是的话，说明主题没配这个 scope，换Adaptive主题验证一下 - 大量非样式字符串拖慢响应？加
"supported_color_names": false关掉预定义色名匹配
真正容易被忽略的是作用域（scope）和主题（theme）的耦合关系——插件只负责打上 scope 标签，颜色由 theme 定义。哪怕配置全对、路径没错、语法也匹配，只要 theme 文件里没写 wordhighlight 或 color_highlighter 的颜色规则，结果就是“什么都没发生”。调试时先切到 Adaptive 或 Monokai Bright 主题，能立刻区分问题是出在插件逻辑，还是主题缺失。
