##按表现定位

表现更可能原因第一检查点
更新提示网络错误更新请求没有拿到订阅内容浏览器或命令行打开 URL
下载成功但节点为空返回内容不是 Clash/Mihomo YAML看是否有 proxies 或 proxy-providers
parse errorYAML 缩进、字段或引用错误用编辑器检查行号附近
更新后网页打不开DNS、规则或系统代理接管异常看日志命中的 DNS 与规则
旧配置能用，新配置不能内核不支持新字段或 provider 拉取失败查看内核版本与 provider 日志

第 1 步：验证 URL 返回内容

Windows 可用 PowerShell：

Invoke-WebRequest -MaximumRedirection 5 -Headers @{"User-Agent"="clash-verge"} -Uri "你的订阅URL" -OutFile "$env:TEMP\profile.yaml"

macOS / Linux 可用：

curl -L -A "clash-verge" "你的订阅URL" -o /tmp/profile.yaml

打开文件后看第一屏：正常情况下应该能看到 proxies:、proxy-groups:、rules:，或者 proxy-providers:。如果看到的是网页登录页、套餐说明、空白页、JSON 包装层或 403/404 文本，就不是 Clash Verge Rev 能直接解析的内容。

如果你的订阅服务提供多种导出格式，Clash Verge Rev 优先选择 Clash/Mihomo YAML。需要重新准备多端导出时，可以使用兼容 Clash / Singbox / V2Ray 的订阅，但导入前仍要确认当前链接的格式。

第 2 步：检查 YAML 关键字段

最小可用结构通常要有节点、分组和规则。provider 写法也可以，但引用名必须一致：

proxy-providers:
  sub-a:
    type: http
    url: https://example.com/profile.yaml
    path: ./providers/sub-a.yaml

proxy-groups:
  - name: Proxy
    type: select
    use:
      - sub-a

常见错误包括：

  1. use 里的 provider 名写错。
  2. proxy-groups 引用了不存在的节点名。
  3. 复制配置时缩进被改成 Tab。
  4. 规则里用了当前内核不支持的字段。
  5. provider 文件下载失败，但主 profile 仍显示更新完成。

第 3 步：比对 Mihomo 内核和 DNS

Clash Verge Rev 是图形客户端，真正处理配置的是 Mihomo 内核。若订阅里使用新字段，旧内核可能启动失败或只加载部分配置。到设置或日志里看当前 core 版本，再对照 Mihomo 文档确认字段支持。

DNS 排查不要和 URL 排查混在一起。建议顺序是：

  1. 关闭 TUN 和系统代理，只测试订阅更新。
  2. 更新成功后再打开系统代理，访问一个国内站点和一个海外服务样本。
  3. 打开日志，查看域名走的是哪条规则、DNS 返回的是 fake-ip 还是真实 IP。
  4. 如果只有浏览器失败，检查浏览器是否有独立代理或 DoH 设置。

验证是否修好

  • Profiles 页面能手动更新，日志没有 parse error 或 provider 下载错误。
  • Proxies 页面能看到节点和分组，分组不是空列表。
  • 访问两个样本网站，日志里能看到对应规则命中。
  • 关闭再打开客户端后，配置仍能自动加载，不依赖旧缓存。

相关阅读

长尾问题速查

现象优先检查验证方式
订阅导入失败URL、User-Agent、证书、订阅格式浏览器打开订阅地址，看客户端日志
节点全红订阅是否过期、DNS、时间、出口端口换同订阅另一个客户端对照
开了代理没网系统代理、TUN、路由表、DNS先测 IP，再测域名
电视和 NAS 不走代理网关、旁路由、DHCP、分流规则用同一域名做设备对照