​

小林学 LangChain：从”能说话”到”会干活”的冒险

这是一套沉浸式叙事教程：跟着小林，一起踩坑、一起顿悟、一起把 LangChain 从零学到能做出”会记住、会调工具、会自主决策”的 Agent。 所有技术细节都是真的（代码可运行、数据来自实测），只有小林这个人是虚构的——或者说，他就是你。

---

​

这套教程怎么读

1. 按编号顺序读（01 → 18），每篇 20~40 分钟。
2. 每篇都跟着小林的验证步骤亲手跑一遍代码——看到同样的输出，知识才是你的。
3. 每篇末尾都有”边界”和”复现信号”，回答”什么时候不适用”和”换个场景怎么认出来”。
4. 配套代码：在 narrative-course/code/（按篇号编号，与教程一一对应），运行环境 learn-langchain。

​

故事线（小林从哪来，要到哪去）

小林是公司的后端工程师，老板让他做一个”基于公司文档自动回答问题”的知识库机器人。他一开始以为这是”调个接口就能搞定的事”，直到他发现：

• 他花了一个周末读 API 文档、拼 JSON、处理各种报错——结果换一个模型供应商，代码全废。
• 模型的”记忆”是个天大的谎言——它每次都是金鱼脑。
• 让它”干活”（调工具）不是给它写 if-else，是给它一副鞍具。
• 最后他发现，自己手搓的所有东西，一个叫 LangGraph 的框架早就内置了。

这一路，他经历了 18 次顿悟。这套教程就是他那 18 次顿悟的现场回放。

​

目录

逻辑顺序 = 认知依赖：先懂”模型返回什么 / 怎么构造输入”（0103），再学对话能力（0406）、知识库（0709）、助手与编排（1011），然后源码总览（1416）、实战与上线（1718）。

---

​

小林的人生信条（也是这套教程的方法论）

1. 不背结论，背过程——“我当时以为……试了发现不对……后来才明白”比”结论是 X”有用一百倍。
2. 每个知识都要能验证——不能跑出结果的”知识”是幻觉。
3. 先要能用，再问原理——先把代码跑通，再回来看它为什么这么设计。

现在，翻到第一篇：第一次对话。小林的第一行代码，就是从一段让他血压升高的 curl 开始的。