大部分「用不了」其实是同一类问题换了种表现：订阅链接返回了登录页、内核被安全软件拦了、TUN 和系统代理同时开着。本页把所有高频故障按发生环节拆成四组，每组给出可复现的判断方法与对应解法，遇到问题时先定位环节，再按步骤排除。
同一句「订阅失败」可能出现在三个完全不同的环节。先分清楚问题出在哪一段，能省下大半折腾的时间。
订阅链接能粘贴进去，但客户端拉回来的内容不对，或者导入后配置列表里看不到条目。
订阅条目还在，但点击更新时报错，或者更新后节点数量明显变少、配置变成空文件。
配置加载正常，节点列表也在，但测速全红，或者打开网页一直在转圈、提示连接超时。
最常见的原因是订阅链接返回的根本不是 YAML，而是登录页、错误页或 403 提示。判断方法很简单：用浏览器直接打开这条订阅链接，观察页面返回的内容。
proxies: 开头的纯文本 → 链接正常，问题出在客户端如果不想打开浏览器，也可以用命令行查看响应前几行，判断更快：
返回 <!DOCTYPE html> 或 <html 开头的，基本都是网页而不是配置，需要回去找机场核对订阅地址与令牌状态。
不一定。先按顺序检查这三处：
clash://install-config?url=...）触发的，需要确认系统已正确把这类链接关联到客户端。浏览器没有弹出「是否打开客户端」的提示，通常意味着关联丢失，可以改用粘贴链接的方式导入。
三个方向排查：
~/.config/clash/ 或 Windows 的 %USERPROFILE%\.config\clash\。部分客户端会使用自己的私有目录，具体路径可在设置页查看放好文件后，需要在客户端里手动刷新一次配置列表，仅复制文件不会自动出现条目。
这类报错通常出现在三个场景：
按从外到内的顺序排查，效率最高：
更新后节点减少，通常不是客户端 bug，而是服务端订阅内容发生了变化。常见原因：
判断方式：用浏览器打开订阅链接，对比一下当前返回的节点数量。如果浏览器里显示的节点也是变少后的数量，那就是机场侧的调整；如果浏览器里正常、客户端里却是空的，说明客户端解析出了问题，可以尝试重新导入。
可以缓解，但无法完全避免。订阅更新本质上是一次配置重载，重载时既有连接会被重新调度，因此出现短暂中断是正常现象。可以从两方面降低影响：
这类「重启就好」的现象，通常指向客户端内部状态没有及时刷新。可能的原因：
重启客户端会清理这些临时状态，因此问题会「自动消失」。如果反复出现，可以在客户端的设置中关闭自动更新，改用手动更新，避免后台任务互相冲突。
按这个顺序看，可以覆盖九成情况：
「开关显示已开」不代表流量真的经过 Clash。分三步确认：
如果怀疑是接管范围的问题，可以临时切到 TUN 模式验证一下。TUN 能接管浏览器，说明问题出在系统代理这一层。
「开 TUN 没网、关 TUN 有网」几乎可以确定是 TUN 接管链路本身出了问题。按以下顺序处理：
通常不是节点问题，而是分流规则或接管范围的问题。具体分两种情形：
间歇性断线的原因比较杂，可以从这几个方向逐一排除：
如果断线后连接日志里出现大量重试记录，说明客户端一直在尝试重连但失败了，此时更值得排查节点或网络侧的问题。
这个报错几乎都指向同一个原因：内核文件被安全软件当成威胁隔离或删除了。Mihomo 内核带有网络代理能力，部分杀毒软件会对它产生误报，把它从程序目录里移走。客户端启动时找不到内核文件，就会抛出 os error。
恢复步骤如下：
启动即崩溃，通常与配置文件或内核权限有关。按下面顺序排查：
这是 macOS 的 Gatekeeper 安全机制，不是文件损坏。有两种放行方式：
配置是否丢失取决于客户端更新时是否清理了配置目录。按以下顺序尝试恢复：
~/.config/clash/ 下的文件，先确认目录里的 YAML 是否完好把客户端弹出的报错文字与下表对照，能更快锁定问题方向。表中列出的是最典型的几种表现。
解析失败 / 返回 HTMLos error / 找不到系统文件Clash Verge Rev 依赖一个独立的内核文件来实际处理网络流量。这个文件带有代理能力特征，容易被部分杀毒软件误判为风险程序并自动隔离。文件一旦消失，客户端启动时就找不到内核，于是抛出 os error。
这不是客户端本身的缺陷，也不是配置问题，本质上是安全软件与代理工具之间的误报冲突。处理方法并不复杂，关键是要把客户端目录加入排除列表，而不是整体关闭防护。
在安全软件主界面找到「隔离区」「病毒查杀记录」或「已阻止的项目」，查看被处理的文件列表。
找到名称包含 mihomo、clash 或 verge 的条目，选择「还原」或「信任」，让它回到原本的位置。
在安全软件的「排除项」「信任区」里，把 Clash Verge Rev 的安装目录整个加进去，避免下次更新时再次被误伤。
如果隔离区里已经找不到文件，直接重新下载安装包覆盖安装即可，内核文件包含在安装包内，装完就能恢复。
可以先回到配置教程确认基础流程是否正确，或到官方仓库的 Issue 区检索关键词——大部分报错都有人遇到过，带上客户端的完整日志提问，通常能更快得到回复。