对比维度

手写 Agent

LangGraph

上手难度

低，只需理解 LLM 调用

中，需学习 Node / Edge / State 概念

代码量

少，逻辑直接

多，需定义图结构

状态管理

手动维护 messages 列表

统一 State 对象，自动传递

控制流

手写 if/while 逻辑

声明式图结构（节点 + 边）

循环 / 分支

手动实现，容易出错

内置条件边，清晰表达

多 Agent 协作

复杂，需自行设计通信

原生支持，节点即 Agent

持久化 / 记忆

需自己实现

内置 Checkpointing

Human-in-the-loop

需手动插入中断逻辑

内置 interrupt 机制

流式输出

需自行处理

开箱即用

错误重试

需手动 try/except

可在节点级别配置

可视化

无

可直接渲染图结构

调试难度

低，逻辑透明

中，需理解框架行为

框架依赖

无

依赖 LangGraph / LangChain

适用场景

学习原理、简单任务

复杂多步骤、生产环境

可维护性

逻辑复杂后难以维护

图结构清晰，易扩展