全中文 + 只讲 JS/TS
市面上 LangGraph 教程 95% 是 Python。这本从头到尾只有 TypeScript，不出现一行 Python。
LangGraph.js中文入门电子书
15 章 · 71 个示例，边读边跑
Skip to content
这本书解决什么问题
如果你搜「LangGraph 教程」，找到的 95% 是 Python：官方课程 LangChain Academy 只有 Python 版，中文社区的资料也几乎全是 Jupyter Notebook。
但 LangGraph.js 不是社区移植、也不是阉割版 —— 它是官方一等公民：
| 事实 | 证据 |
|---|---|
| 官方库持续发版 | @langchain/langgraph v1.4.x，与 Python 同步维护 |
| 官方文档有完整 JS 分支 | docs.langchain.com/oss/javascript/langgraph/overview |
| JS 与 Python 文档逐页对应 | 两边 26 个页面 slug 完全一致 |
| npm 生态齐全 | langgraph / checkpoint-* / supervisor / swarm / sdk-react … |
| 生产用户 | Replit、Uber、LinkedIn、GitLab |
缺的不是「库」，是「中文的、写给 JS 工程师看的课」。 这本就是来补这个缺口的。
这本书适合谁
- 会 JavaScript / TypeScript，想学 AI 智能体编排
- 需要让流程能分支、能循环、能暂停等人审批、能记住历史 —— 而「链」做不到
- 希望边读边跑代码，看到真实输出，而不是只看理论
💡 唯一的硬门槛是「会 JS/TS，用过 npm」。AI / 大模型相关的背景知识不需要，用到什么讲什么。
阅读顺序
0 环境准备 → 1 第一个图 → 2 状态与 Reducer → 3 控制流 → 4 持久化与记忆
→ 5 人工介入 → 6 流式输出 → 7 多智能体 → 8 工程化与部署
→ 9 编排设计模式 → 10 应用结构 → 11 从 LangChain 迁移
→ 12 测试与调试 → 13 函数式 API → 14 前端集成建议按顺序读，后面章节大量复用前面的概念。第 1 章那张「两个节点 + 一条条件边」的 ReAct 图是全书的地基，务必吃透再往下走。
💡 如果你的目标很明确，可以跳读：从 LangChain 过来的先看第 11 章；只想把服务跑起来的看第 8 章；代码已经写乱了的看第 10 章；要给前端做界面的直接看第 14 章。
快速开始
bash
# 1. 克隆本书源码（两个地址选一个，内容同步）
# 1. 克隆（两个地址选一个，内容同步）
git clone https://github.com/cleversnail/LangGraph_js_cn.git
cd LangGraph_js_cn
# 或国内（Gitee，通常更快）
# git clone https://gitee.com/snail_wn/lang-graph_js_cn.git
# cd lang-graph_js_cn
# 2. 安装依赖（需要 Node >= 20）
npm install
# 3. 配置模型（填入你的 API Key / 接口地址 / 模型名）
cp .env.example .env
# 4. 跑通第一个图
npx tsx 01-first-graph/code/01-hello-graph.ts
# 5.（可选）一键验证全书 71 个示例，约 20-30 分钟
npm run verify不想用 Git？打开仓库点「Code → Download ZIP」，解压后从第 2 步开始。
源码地址：GitHub ｜ Gitee（两处同步，选能打开的）
完整说明见 第 0 章 · 环境准备。
内容来源
本书基于 LangGraph.js 官方文档与示例（langchain-ai/langgraphjs，MIT License）整理、翻译并重排为中文学习路径，补充了大量 JS 工程师视角的讲解、踩坑记录与工程化实践。本中文版仅供学习使用。