d doeda-zogt.xyz
doeda-zogt.xyz · TIMES
All The News, Wisdom & Knowledge
VOL. MMXXVI · doeda-zogt.xyz · the-graphgithub
特别报道 · SPECIAL REPORT

The GraphGitHub仓库导览:子图开发者的资源地图

系统介绍The Graph在GitHub上的核心仓库、官方示例与社区项目,帮助开发者快速找到子图模板、Indexer工具与生态项目,加速开发与上线。

发布于 2026-05-24T06:12:21.444008+00:00更新于 2026-05-24T15:54:23.430969+00:00
The GraphGitHub - The GraphGitHub仓库导览:子图开发者的资源地图
图:本报记者摄 · 关于「The GraphGitHub仓库导览:子图开发者的资源地图」的视觉记录

The Graph 的发展离不开 GitHub 上的开放生态。无论你是想找子图模板,还是希望深入研究 Indexer 协议,几乎所有线索都能在仓库里找到。本文按使用场景把 GitHub 资源分类整理。

官方核心仓库

在 graphprotocol 组织下,graph-node 是核心节点实现,graph-cli 是开发者工具,graph-ts 提供 AssemblyScript 类型定义。三者构成了子图开发的最小可用集合。建议把它们都加入到本地 IDE 的索引中,遇到不懂的接口直接跳转源码,比看文档更直观。配合 The Graph官方文档 阅读,会有事半功倍的效果。

示例子图集合

官方维护了一个 example-subgraphs 仓库,覆盖 Uniswap、Aave、ENS 等知名项目的最简实现。新人入门的最快路径就是 clone 下来跑一遍,再把逻辑替换成自己业务的。结合 The Graph实战教程 中的步骤,你能在一周内交付第一个上线版本。

Indexer 与去中心化网络相关工具

indexer-agent、indexer-cli、indexer-service 等仓库面向 Indexer 运营者。即使你只做应用开发,也建议浏览一遍,理解 Indexer 在选择子图、分配查询、提交 PoI 时的行为。这样在去中心化网络发布时,能更好地预判时机。

社区贡献的子图

大量优秀子图托管在第三方仓库,例如 Messari 子图标准、Curve 的官方子图等。它们通常代码质量高、注释充分,是学习 Mapping 写法的好教材。可对照 The Graph代码示例 中的模板,体会同一类业务的不同实现风格。

CI/CD 与运维脚本

部分仓库提供了完整的 CI 模板,可以直接复用。重点关注其测试矩阵、依赖锁与发布 hooks。把这些经过实战检验的脚本搬到自己的项目里,能省下大量重新摸索的时间。

如何高效检索

GitHub 自身的搜索语法对子图开发极其友好。例如 org:graphprotocol path:subgraph.yaml 可以快速定位所有官方子图配置。结合 The Graph最佳实践 中的常用关键词列表,你可以在几分钟内找到一个新协议的子图。

把仓库当成学习路径

建议按「核心代码 → 示例项目 → 社区子图 → 工具脚本」的顺序逐步阅读。每读完一类,写一份学习笔记,三个月后你对 The Graph 的整体认知会非常扎实。

GitHub 不只是代码托管,更是去中心化数据基础设施的知识地图。常翻常看,你会持续从中获得灵感与解决方案。