源码学习 · 10 期 200 讲
Higress 源码学习总目录
把 Higress 控制面 → 数据面 → Wasm 插件 → AI 网关能力 完整拆解为 10 期独立讲义，每期 20 讲，共 200 讲。每期一个页面，每讲对应一个具体代码切片（文件、函数或概念），由浅入深、逐讲深入。建议从第 01 期顺序读起，遇到不熟悉的主题随时返回本目录跳读。
10 期一图速览
| 期 | 主题 | 读完获得 | 难度 |
|---|---|---|---|
| 第 01 期 | 项目入门与架构总览 | 建立全局心智模型 | ★ |
| 第 02 期 | 控制面启动与初始化 | 读懂 main → Server 全链路 | ★★ |
| 第 03 期 | Istio Pilot 复用与 xDS | 看清 Higress 与 Istio 的接缝 | ★★★ |
| 第 04 期 | K8s 资源监听与 Controller | 掌握 Informer + workqueue 范式 | ★★★ |
| 第 05 期 | IngressConfig 翻译核心 | 吃透 2085 行翻译大脑 | ★★★★ |
| 第 06 期 | Annotation 解析器深度 | 能给 Higress 加新注解 | ★★★ |
| 第 07 期 | 服务发现与 McpBridge | 会写新注册中心适配器 | ★★★ |
| 第 08 期 | WasmPlugin 与 wasm-go SDK | 会写 Higress Wasm 插件 | ★★★★ |
| 第 09 期 | AI 网关插件家族 | 会扩展 LLM Provider | ★★★★ |
| 第 10 期 | MCP / 证书 / hgctl / 收官 | 形成完整知识闭环 | ★★★ |
学习建议
- 边读边对照源码：本地准备一份
github.com/alibaba/higress，每讲都指明了具体文件路径与函数名，IDE 全文搜索即可定位。 - 按需跳读：如果只关心 AI 网关，可直接跳 09 期；只关心限流/灰度可跳 06 期；只想做插件可直接跳 08 期。
- 不必背 API：重点关注"为什么这么设计"，记不住代码细节没关系，记住核心抽象（IngressConfig、Watcher、Provider、Wasm Phase）就行。
- 用思考题自检：每讲末尾都有思考题，能回答说明真懂了。
版本说明
本系列以 Higress v2.x 主分支为基准（含 ai-* 与 mcp-* 插件）。Higress 演进很快，行号会变，但核心架构（控制面 → IngressConfig → Pilot xDS → Envoy + Wasm）多年稳定。如果你看到的源码与本文细节不符，以本仓库当前状态为准，思想仍然适用。