highlight_word“看不见”匹配项是因为高亮被highlight_line、暗色主题背景色或光标位置干扰；需检查设置、关闭干扰项、修改配色方案背景色，或改用WordHighlight插件实现选中才高亮。
为什么highlight_word在调试时总“看不见”匹配项？
不是功能失效，而是高亮被其他视觉层吃掉了。最常见的是highlight_line开着时整行背景变深，把highlight_word那层浅色底直接盖住；暗色主题（比如Monokai）默认把高亮区域的background设成#333333这种近似背景色，肉眼根本分不出差别；光标停在user_id的下划线位置、开头引号或结尾分号上，Sublime 就不触发单词识别。
确认方法很简单：新建一个空白文件，输入foo foo，把光标精确停在第一个f上——如果第二个foo没浅灰底，就说明真被关了或压住了。
- 打开
Preferences → Settings，只看右侧「用户设置」，删掉或改成"highlight_word": true（如果存在且为false） - 临时关掉
"highlight_line": true，排除干扰 - 确保状态栏右下角没亮着
*（正则模式开启会覆盖匹配逻辑）
怎么让高亮只响应选中，而不是悬停就亮？
原生highlight_word没有这个开关，它就是设计成“光标悬停即高亮”。想改成“只在选中时触发”，必须装插件。
WordHighlight是目前最稳定的选择。装好后，在WordHighlight.sublime-settings里加这一行：
{"highlight_when_selection_empty": false}
注意两点：
- 插件高亮比原生慢一点，滚动大文件时偶有延迟
- 它不区分作用域——
data在字符串里和变量名里都会被标出来，调试时容易误判 - 如果同时装了
BracketHighlighter或HighlightWords，它们可能抢走高亮控制权，得一并检查禁用
如何调出真正醒目的调试高亮色？
别指望换主题碰运气。真正起效的是改配色方案文件里的Highlight scope。
步骤很直接：
- 菜单
Preferences → Color Scheme，记下当前路径，比如Monokai.sublime-color-scheme - 把它复制到
Packages/User/目录下（避免覆盖原主题） - 在新文件里搜
"name": "Highlight"或"scope": "region.yellowish" - 改
"background"值，例如："background": "#ffcc0040"（带透明度的亮黄）
WordHighlight的highlight_color只控制边框或填充，不改背景底色——真正影响调试可见性的，永远是这个background值。
highlight_matching_words和highlight_word_under_cursor有什么区别？
这两个设置常被混用，但行为完全不同：
-
highlight_matching_words：只在你**手动选中一个词**后才高亮全文档所有相同词，适合精准定位某次修改涉及的所有位置 -
highlight_word_under_cursor：只要光标落在词内（哪怕没选中），就自动高亮——更适合快速扫读变量生命周期，但容易在密集代码里造成视觉干扰
调试时建议组合使用："highlight_matching_words": true + "highlight_word_under_cursor": false，再配合WordHighlight的highlight_when_selection_empty: false，这样能确保高亮只出现在你明确关注的上下文里，不会被意外触发干扰判断。
