
先看结构,再写配置。
一份配置如同一套图纸:每个层级负责一件事,引用将它们连接起来。

空格之中,
有清晰的层级。
YAML用缩进表达关系。键值、列表、注释与字符串各有边界;先读懂父级,再修改字段。
- 用空格缩进,同级字段保持对齐
- 短横线声明列表项,子字段归属明确
- 特殊字符串使用引号,注释放在合适位置

mode: rule
log-level: info
proxy-groups:
- name: "手动选择"
type: select
proxies:
- DIRECT
rules:
- MATCH,手动选择来源有序,选择才清楚。
Mihomo订阅管理与代理设置是相连的两个层次:先确认节点从哪里来,再决定如何选择。
规则的顺序,
就是阅读的顺序。
Mihomo规则分流通常由上到下匹配。先安排精确例外,再处理较宽条件,最后交给兜底策略。
DOMAIN完整域名的精确条件DOMAIN-SUFFIX域名本身与子域名范围RULE-SET引用已定义的规则集MATCH此前未匹配请求的兜底
这是常见组织思路,具体规则仍需按实际需求安排。规则命中不等于远端连接一定成功。
阅读规则分流指南 →
六份手记,一条清晰的路径。
从一处缩进错误,到一次完整的配置验证。按问题阅读,也可以循序查阅。

YAML缩进与层级
从报错行向上检查父级键、空格、列表和字符串,区分YAML解析错误与Mihomo字段错误,逐步恢复可加载的配置文件。
阅读手记
节点来源与提供者
比较主配置中的proxies与http、file、inline节点提供者,梳理名称、路径和代理组use引用,避免格式混用与来源冲突。
阅读手记
代理组策略选择
理解手动选择、延迟检测和顺序回退的差异,核对proxies与use引用,判断策略变化的作用范围与检测局限。
阅读手记
规则顺序与命中
通过精确域名、后缀、规则集和兜底的匹配过程,检查活动配置与策略引用,区分规则命中和远端连接结果。
阅读手记
订阅更新与缓存
沿远程内容、本地缓存、提供者解析、代理组引用和活动配置逐层检查,定位订阅刷新后节点未变化的原因。
阅读手记
配置验证与生效
用五层状态排查配置未生效的问题,核对YAML、字段引用、活动路径、加载日志和新连接,并介绍准确的配置测试参数。
阅读手记Mihomo YAML配置为什么对缩进和空格有要求?
缩进决定键值与列表的归属。使用空格并保持同级对齐,不能用Tab代替普通缩进。检查层级与常见语法错误。
proxy-providers与proxies分别表示什么?
主配置的proxies直接定义节点,proxy-providers管理节点内容的来源;代理组通过use引用提供者。理解节点来源的区别。
规则已写入文件,为什么连接仍不符合预期?
先确认活动配置已加载,再查是否命中更靠前的条件,并核对目标代理组当前选项。阅读规则顺序排查。
订阅更新后,需要检查哪些状态?
检查拉取结果、缓存内容、提供者解析与代理组引用。修改主配置时还应确认核心加载成功。按更新链路逐项核对。

