WordHighlight 在 Sublime Text 4 中已不兼容,因其自 2019 年停更且依赖的 API(如 sublime.RegionSet)被移除,安装后会出现 ImportError 或无响应;ST4 原生支持双击单词后按 Ctrl+Ctrl+F(macOS 为 Cmd+Cmd+F)高亮全文匹配项,按 Esc 即可清除,更轻量稳定。

WordHighlight 插件在 Sublime Text 4 中已不兼容
Sublime Text 4 默认禁用所有未签名或未更新的第三方插件,WordHighlight 自 2019 年后就停止维护,其原始仓库已归档,无法在 ST4 上正常加载。你即使通过 Package Control 安装成功,也会遇到 ImportError: No module named 'sublime_plugin' 或插件完全无响应的情况。
- ST4 的 API 有重大变更,尤其是对
view.find()和区域高亮机制的重构 - 原插件依赖的
sublime.RegionSet在 ST4 中被移除 - Package Control 搜索到的 “WordHighlight” 多为镜像旧版,安装后
Ctrl+Click或自动高亮均失效
替代方案:用内置的 “Find All” + 高亮标记
ST4 原生支持单词级全文高亮,无需插件——只需双击选中单词,再按 Ctrl+Ctrl+F(Windows/Linux)或 Cmd+Cmd+F(macOS),即可高亮当前视图中所有匹配项。这个操作调用的是 find_all 命令,底层使用正则 \b{word}\b,保证词边界安全。
- 高亮颜色由当前 color scheme 的
highlightscope 决定,可在Preferences → Color Scheme中切换主题查看效果 - 按
Esc可一键清除所有高亮,比插件更轻量 - 若需区分大小写,先打开
Find → Case Sensitive(Alt+C),再执行Ctrl+Ctrl+F
需要自动高亮?改用 WordHighlightPlus(仅限 ST3)或手动配置
如果你坚持要“鼠标悬停即高亮”,且使用的是 Sublime Text 3(3211 及以前版本),可安装社区维护分支 WordHighlightPlus:
Package Control → Install Package → 输入 "WordHighlightPlus"
安装后默认启用,但要注意几个关键配置项:
-
"highlight_on_select": true—— 选中时才高亮(避免误触发) -
"ignore_case": false—— 默认区分大小写,防止HTML和html混淆 -
"file_extensions": ["js", "py", "cpp"]—— 显式限定语言,避免在 Markdown 或日志文件中误高亮
ST4 用户若真需类似功能,目前唯一稳定方式是编写自定义 plugin,监听 on_selection_modified 事件并调用 view.add_regions(),但需自行处理 region 清理和性能节流——稍有不慎就会卡死编辑器。
为什么别硬套老教程里的 “Package Control 安装 WordHighlight”
几乎所有中文教程写的安装步骤都停留在 ST2/ST3 时代,它们让你:
- 打开 Command Palette →
Package Control: Install Package - 搜索并安装
WordHighlight - 重启 Sublime —— 然后发现没反应
问题不在操作步骤,而在底层:ST4 的插件沙箱拒绝加载含 import sublime 但无 __init__.py 或未声明 sublime_api_version 的模块。你看到的“安装成功”只是文件拷贝完成,实际从未注册进插件系统。
真正省事的做法,是接受 ST4 的原生行为——双击 + Ctrl+Ctrl+F,快、稳、无兼容风险。那些花式配置、热键映射、排除列表,反而掩盖了最简路径。










