文档之外，图文并茂的教程往往更受新手欢迎。本文以币安智能链上一个简单的代币合约为例，配合关键步骤的截图，把第一个 The Graph 子图跑起来。
环境准备
首先安装 Node.js 与 Docker。Node 推荐 18 或更高版本，Docker 用于本地启动 graph-node 与 IPFS。把 graph-cli 全局安装：npm install -g @graphprotocol/graph-cli。安装完成后执行 graph --version，能看到版本号就证明环境已经就绪。如果出现路径找不到，请参考 The Graph入门指南 中的环境变量配置章节。
初始化子图
执行 graph init 后按提示选择 BSC 网络与合约地址。脚手架会自动从区块浏览器拉取 ABI，并生成 schema.graphql、subgraph.yaml 与 src 目录。这一步成功的标志是终端出现绿色的「Subgraph created」提示。
编写 Mapping 函数
打开 src 下的 handler 文件，把模板代码改为实际业务逻辑。简单代币只需要在 Transfer 事件中更新 from 与 to 两个用户的余额即可。完整代码可以参考 The Graph代码示例 中的标准模板。
本地启动 graph-node
使用官方 docker-compose 模板启动 graph-node、IPFS 与 PostgreSQL。三者启动完成后，执行 graph create --node http://localhost:8020 my-subgraph 创建子图实例。如果遇到端口冲突，对照 The Graph常见错误 中的端口表逐项排查即可。
部署与查询验证
执行 graph deploy --node http://localhost:8020 --ipfs http://localhost:5001 my-subgraph 完成本地部署。等待几分钟，graph-node 会同步到最新区块。打开 http://localhost:8000，输入测试查询，看到返回数据即代表流程跑通。
截图核对要点
常用截图清单包括：环境版本输出、graph init 成功界面、subgraph.yaml 关键字段、查询页面返回结果。建议把这些截图保存到团队 wiki 中，新人入职时一目了然。结合 The Graph部署教程 中的线上流程，可以无缝衔接到正式环境。
常见卡点
新人最容易卡在 Mapping 报错、同步缓慢、查询为空三件事上。把这些卡点整理成 FAQ，并持续补充团队遇到的真实问题，几个月后你就能拥有一份独家手册。
按这份图文教程跑一遍，对 The Graph 的运行机制会有直观感受。后续无论做哪种业务，都不会再有「从零开始」的陌生感。