1. 报错根因诊断一：下载回来的实际是 HTML 网页源码
这是 80% 的用户遭遇「Invalid YAML Syntax」的根本原因：
- **现象**：客户端提示解析失败，但用户在浏览器里访问似乎能打开；
- **真实底层逻辑**：
- 机场的订阅域名开启了 Cloudflare 防护或反爬 WAF 规则；
- 当 Clash Verge Rev 发起 HTTP GET 请求时，Cloudflare 识别其 User-Agent 为自动化工具，直接拦截并返回了包含 JavaScript 挑战验证码的 **HTML 网页代码（以 `<!DOCTYPE html>` 开头）**；
- 客户端将这几百行 HTML 代码当作 YAML 提交给 Go 语言反序列化器，解析器在第 1 行读到 `<!DOCTYPE` 时直接崩溃抛出：`yaml: line 1: did not find expected key`。
💡 右键订阅卡片选择「查看源码」，如果第一行是 html 标签，100% 属于 WAF 拦截。
2. 报错根因诊断二：节点名特殊符号引发的 YAML 解析死锁
部分机场为了美观，在节点名称中加入大量复杂的 Emoji 表情符号、国旗图案或未经转义的半角标点：
### 致命语法违规示例：
```yaml
# 错误示范 (未加引号，冒号后跟空格被识别为非法键值映射):
proxies:
- name: 🇭🇰 香港 01: 物理专线 # 极速
type: ss
# 正确示范 (使用双引号安全包裹):
proxies:
- name: "🇭🇰 香港 01: 物理专线 # 极速"
type: ss
```
如果机场后台未对含有 `:` 或 `#` 的节点名进行引号包裹，客户端在拉取后就会触发语法抛错。
bash
# Linux / macOS 终端使用 Python 本地快速检测 YAML 文件具体报错行号
python3 -c "import yaml; yaml.safe_load(open('config.yaml'))"3. 应急自救修复工作流
如果机场技术人员未及时修复，用户可以通过以下步骤临时恢复网络：
1. 打开客户端配置存储目录（Windows：`%APPDATA%\io.github.clash-verge-rev.clash-verge-rev\profiles`）；
2. 找到对应报错的 `.yaml` 临时文件；
3. 使用 VS Code 或 Notepad++ 打开，搜索报错行号；
4. 将格式错误的行手动修正或直接删除该节点，保存文件；
5. 在客户端中将订阅类型临时切换为「Local（本地配置）」，即可立即正常启动代理。
❓ 常见疑问与排查步骤
为什么同一个订阅在手机小火箭上正常，在电脑 Clash 上报错？
因为小火箭通常只拉取 Base64 单节点列表并在手机本地重新生成配置，容错率极高；而 Clash 直接解析完整的 YAML 文本树，任何缩进错位或语法违规都会直接拦截报错。
怎么彻底解决 Cloudflare 五秒盾拦截？
联系机场管理人员在 Cloudflare 后台针对客户端订阅 API 路由（如 `/api/v1/client/*`）配置「WAF 绕过规则（Skip Challenge）」。
用记事本修改保存后报错更多了怎么办？
Windows 原生记事本保存时可能会自动添加 UTF-8 BOM 签名，导致 Go 解析器彻底报废。请使用专业的 VS Code 编辑器保存为无 BOM 的 UTF-8 编码。