Smart Highlighting需先启用开关再配置样式，否则双击无高亮；必须在Global Styles中设置Smart Highlighting背景色并保存，且需修正词分隔符以确保完整单词匹配。

Smart Highlighting 必须手动启用，勾选“启用智能高亮”只是第一步

双击单词后全文件同名项不亮，90% 是因为只开了开关、没配样式。Notepad++ 把“启用能力”和“定义样式”拆成两步：设置 → 首选项 → 高亮 里勾上 启用智能高亮，仅表示允许该功能运行；真正控制颜色的入口在别处。

下一步必须进 设置 → 语言格式设置 → Global Styles，在左侧样式列表中滚动找到 Smart Highlighting（注意拼写是 HighLighting，不是 Highlighting），双击它才能调背景色。改完不点右下角 保存并关闭，所有设置都不生效——重启软件也没用。

词边界定义错误会导致双击只高亮一半，比如 user-name 变成 user 或 name 单独亮

Smart Highlighting 不是字符串匹配，它依赖 Notepad++ 对“什么是完整单词”的判断。默认词分隔符包含 -、.、_ 等符号，所以双击 api.v1 或 user_name 会被切成多个片段，只高亮其中一部分。

• 去 设置 → 首选项 → 语言，找到当前文档对应的语言（如 XML、Python），点击右侧 定义词分隔符
• 把不该当分隔符的字符（如 _、.、-）从 Word separators 列表里删掉，加到 Word characters 中
• 修改后已打开的文件需重新双击一次才刷新识别，不用重启

高亮颜色看不见？大概率被 Current line background 或 Mark Style 盖住了

设了 Smart Highlighting 背景色却看不到效果，不是配置失败，而是视觉层叠冲突。Notepad++ 的渲染顺序是：语法高亮 Current line background 设成不透明深色，它就会盖掉 Smart Highlighting。

• 检查是否开了 设置 → 首选项 → 编辑 → Current line background，如果开了，建议用带 Alpha 的值（如 #e0e0e080）降低遮盖力
• 按 Ctrl+1～Ctrl+5 做过标记？那些高亮优先级更高，先按 Ctrl+Alt+0 清除所有标记再试
• 搜索时开启的“高亮所有匹配项”和 Smart Highlighting 互不干扰，但视觉容易混淆；临时关掉搜索高亮可快速验证是不是 Smart Highlighting 真失效

文件没指定语言，Smart Highlighting 完全不触发

新建空白文档或打开无后缀文件（如 Rakefile、.env），底部状态栏显示 Normal text，此时双击任何词都不会触发 Smart Highlighting——它根本不工作。

必须手动指定语言：

• 点击右下角语言名（如 Normal text），从菜单选对应语言（如 Ruby、JSON）
• 更高效的方式是按 Ctrl+L，再按语言名首字母（如 J 切 JavaScript）
• 想永久绑定扩展名，进 设置 → 样式配置器，选目标语言，往 User ext. 里填 env Rakefile（不加点，空格分隔）

语言模式不对，词分隔符配置和 Smart Highlighting 都白搭。这个前提条件最容易被忽略，也最难排查——因为界面没有任何报错提示。