Wox 打不开、搜不到、插件失效？8 类故障的排查顺序（2026）

先判断故障落在哪一层

大多数人排查 Wox 的方式是「重启试试」，无效之后就开始翻 GitHub Issues，结果在几百条讨论里越看越乱。更高效的做法是先判断故障停在哪一层，因为每一层的症状特征非常分明。

Wox 的工作链路可以拆成四段：进程活着 → 热键收到 → 索引命中 → 插件返回。任何一段断掉，表现都不一样。对照下表先定位层级，再往下看对应小节。

故障一：进程没起来，热键完全无反应

先看任务栏右下角的托盘区有没有 Wox 图标。有图标说明进程在，跳到故障二；没有图标，说明进程压根没启动。

按 Ctrl+Shift+Esc 打开任务管理器，在「详细信息」里找 Wox.exe。如果完全找不到，按顺序试：

• 从开始菜单重新启动 Wox，观察是否有报错弹窗
• 如果启动后立刻消失，多半是配置文件损坏 —— 把 %APPDATA%\Wox\Settings.json 改名备份，再启动一次，程序会重建默认配置
• 如果提示缺少运行库，装一遍 Visual C++ 运行库（v1 依赖较老版本，v2 需要 .NET 运行时）
• 检查杀毒软件隔离区。Wox 需要全局热键和文件索引权限，行为特征容易被误判 —— 这是「昨天还能用、今天突然消失」最常见的原因

故障二：进程在，但按热键没反应

这是发生频率最高的一类。本质是热键注册失败——Windows 的热键是独占的，先注册的赢。

最常见的抢占者是同样默认使用 Alt+Space 的工具：Listary、EverythingToolbar、部分输入法、以及某些窗口管理软件。另外，以管理员权限运行的程序拥有更高的热键优先级，如果你的终端是管理员身份启动的，它可能抢走了组合键。

验证方法很简单：先在设置里把热键换成 Ctrl+Space 或 Alt+反引号，如果立刻恢复正常，就确认是热键冲突，而不是程序本身有问题。

• 在 Wox 设置 → 热键里改一个不常用的组合，测试是否恢复
• 临时退出 Listary / EverythingToolbar / 窗口管理工具，再测原热键
• 确认没有以管理员身份运行的终端或 IDE 常驻
• 如果全部无效，检查输入法是否处于「全角」或「中文标点」状态，部分输入法会吞掉组合键

故障三：能呼出，但搜索结果是空的

窗口正常弹出、输入也正常，但列表始终为空，说明索引层出了问题。Wox 本身不建文件索引，它依赖 Everything 的索引（或自带的轻量索引）来查文件。

先分辨是「全部搜不到」还是「只有文件搜不到」：

• 输入 calc 能不能调出计算器？能，说明程序索引正常，问题在文件索引
• 输入 setting: 能不能列出系统设置项？能，说明内置索引正常

如果只有文件搜不到，按这个顺序处理：

1. 确认 Everything 正在运行，且其索引数据库没有报错
2. 检查 Wox 设置里 Everything 的路径是否指向正确的安装位置（换过安装目录后经常失效）
3. 如果整个盘符都没结果，去 Everything 的「索引 → 文件夹」里确认该盘是否被排除
4. 索引刚重建时会有几分钟空窗期，等它跑完再试

故障四：文件能搜，插件指令全部失效

能搜到文件说明主程序与索引都健康，问题出在插件进程。Wox 的插件是独立运行的子进程，某个插件崩溃会把整个插件层带下去。

排查顺序：

• 打开设置 → 插件，看插件列表是否为空。为空说明插件目录被清空或路径错误，检查 %APPDATA%\Wox\Plugins\
• 列表有插件但指令无效，逐个禁用再启用，定位是哪一个把整层拖垮
• v1 与 v2 的插件互不兼容。如果你同时装过两个版本，残留的旧插件会让新版启动失败，清理一次 Plugins 目录通常能解决

关于插件版本的判断标准，可以看 Wox 设置里的版本号：v1 系列（1.4.x）用 Python 插件，v2 系列（2.0-alpha 及以后）换成了新架构，网上大量教程仍然是 v1 写法，照抄会失败。

故障五：开机不自启，每次都要手动点

Wox 的开机启动依赖注册表启动项或计划任务。常见的失效原因是优化软件、安全软件把启动项「优化」掉了。

• 任务管理器 → 启动 → 找到 Wox，状态设为「已启用」
• 如果启动项里根本没有 Wox，打开 Wox 设置 → 通用 → 勾选「开机启动」，让程序自己重新写入
• 用了第三方启动管理器（如 Autoruns）时，确认没有留下被禁用状态

故障六：能用，但输入卡顿、弹窗延迟

输入延迟通常来自三个方向：插件太多、索引范围太大、或者界面渲染被拖慢。

故障七：崩溃闪退与界面白屏

处理崩溃的原则只有一条：先拿到日志，再谈解决。没有日志的猜测基本等于碰运气。

• v1：日志在 %APPDATA%\Wox\Logs\，按日期分文件
• v2：日志在同级 Logs 目录，格式不同但内容更完整

打开最后一次崩溃时间点的日志，搜索 Exception、Error、crash 三个关键词。绝大多数崩溃都能直接读出是哪个插件或哪个配置文件解析失败。

白屏但进程还在，通常是 WebView / 内置浏览器组件渲染失败。更新系统 WebView2 运行时，或在设置里切换到传统界面，多数情况能恢复。

什么情况下重装比排查更快

不是所有问题都值得排查。出现下面三种情况，直接重装更省时间：

1. 配置目录被破坏，改什么都无效，且你没有定制过太多内容
2. 从 v1 升到 v2 后反复出问题，且旧版插件你并不依赖
3. 杀毒软件反复隔离主程序，且你无法把目录加入白名单

重装前务必做两件事：备份 %APPDATA%\Wox\ 整个目录，以及导出你自定义的热键与别名清单。前者保配置，后者保习惯。

一份可以直接照做的自检清单

把下面这几步按顺序走一遍，九成问题会在前三步就暴露：

• 托盘区有没有图标 —— 判断进程是否存活
• 换个热键试试 —— 判断是否被抢占
• 输入 calc 看有没有结果 —— 区分「全空」与「只有文件空」
• 看设置里插件列表是否为空 —— 判断插件层是否整体失效
• 打开日志目录搜 Exception —— 定位具体报错
• 备份配置目录后重建 —— 兜底方案

如果你按这套顺序仍然卡在某一步，把日志里那段报错贴出来，比描述「打不开」有用得多。