先区分错误发生在哪一步
ClashVerge常见错误可以按发生步骤划分：获取资料失败、配置解析失败、客户端启动异常、系统代理不一致或具体目标无法连接。虽然它们可能都表现为“用不了”，但检查对象不同。先记录原始提示和复现步骤，再选择对应方法。
如果问题刚好发生在更新或修改之后，保留这个信息，但不要同时回退软件、切换网络和重写配置。一次检查一个条件，才能判断变化与结果是否有关。以下方法提供基础排查顺序，具体系统与版本问题仍以项目当前文档为准。
导入失败：查看资料和获取过程
导入失败时，确认是读取本地文件失败，还是获取订阅内容失败。检查文件是否存在、权限是否允许读取、返回内容是否属于预期格式，以及来源是否有效。订阅地址返回登录页面、错误页面或其他格式时，不能因为网页能够打开就当作配置已经有效。
记录导入时间和错误类型，隐藏完整地址中的令牌。不要在公开讨论中贴出凭证，也不要不断复制导入同一资料而不查看原因。若获取成功但解析失败，则转到结构检查，避免把两类问题混为一谈。
解析失败：从结构与引用开始
根据提示行号检查缩进、列表层级、标点和字段名称，再看相关策略是否存在。被指出的行可能只是解析无法继续的位置，附近内容也值得观察。保留原文件，在副本中修正一个明确问题，保存后重新加载。
规则引用、代理组名称与资源引用应彼此对应。不要通过删除全部规则来暂时隐藏提示，也不要将未知脚本作为通用修复。可参考配置管理教程与规则知识，理解内容之间的关系。
启动异常：记录系统和运行提示
应用无法打开、界面不显示与相关组件启动失败，应分别记录。确认安装来源、系统架构、当前运行实例和错误原文；若提示缺失组件，查看项目对应平台文档。不要从不明下载页获取系统库文件，也不要为了启动应用而关闭系统安全功能。
端口相关提示则需要核对客户端设置与当前占用情况。先查看是否启动了重复实例或其他使用相同位置的工具，不随意结束未知系统进程。平台入口分别见Windows、macOS和Linux指南。
连接异常：按影响范围检查
单个目标无法访问时，关注目标、规则和对应错误；单个应用异常时，核对应用独立网络设置；多个应用都受影响时，检查本地网络、系统代理和客户端运行。退出客户端后仍无法联网，优先观察系统是否指向已经停止的本地监听服务。
延迟测试、日志和实际应用结果需要相互对照。按连接状态检查教程保存观察和单项调整结果。若仍无法解释，整理最小复现步骤和脱敏日志，再查阅项目文档或公开问题记录，避免只提交一个没有上下文的错误截图。