LangChain 中文工程验证站
LangChain 中文网
LangChain v1 与 LangGraph 的每个结论，都在固定版本下实际运行过，并写明验证了什么、没验证什么。
想找某个报错或关键词？用顶部的搜索框，电脑上按 Ctrl + K 或 ⌘ K。
你现在卡在哪一步？
四类常见问题，每一类都有一条读下去的路线。
直接解决一个问题
知道自己要做什么？直接进对应的文章。
认识 LangChain 生态
日常开发最常碰到的四个名字。
LangChain构建智能体
create_agent 把模型、工具和中间件组合成智能体，让模型在循环里调用工具直到任务完成。
LangGraph编排与恢复
需要精确控制流程、长任务恢复或人工介入时使用，重点是 checkpoint 保存了什么。
LangSmith追踪与评估
接入追踪之前，先弄清楚会向外发送什么数据，脱敏开关实际清除了什么。
langchain-classic旧接口兼容
旧版的 LLMChain、AgentExecutor 等接口移到了这里，可以先换 import 保持行为，再逐步迁移。
最新文章
每篇都写明适用的包版本和验证日期。
旧教程在 LangChain v1 跑不通？新旧写法对照与报错速查12 组旧 import、6 种旧调用方式逐条对照，附报错原文速查和推荐迁移顺序。LangChain v1 入门：第一个智能体invoke 的 7 种输入写法里，有两种不报错但问题没送达模型。附 7 个新手常见错误。工具调用 schema 排障docstring 怎么写、参数校验失败时模型看到什么、工具抛异常会发生什么。模型调用的延迟预算默认没有超时；退避、Retry-After 和两层重试叠加之后，最坏要等多久。LangChain 生产发布检查表把上线前的核对写成可以执行的预检，并用故障注入和并发会话验证。RAG 切分与 Retriever 基准中文语料上，chunk_size、overlap 与 MMR 怎么影响召回和上下文长度。
常见问题
跟着做需要 OpenAI 之类的 API Key 吗？
不需要。文章里的实验脚本用的是脚本化的测试替身模型，不联网、不要密钥，你在自己电脑上就能复现页面上的每一行输出。它只能说明框架本身的行为，不代表真实模型的效果；换成真实模型要改哪里，见入门文章第五节。
文章里的代码和输出可信吗？
能不能复现，是判断可信与否的标准：每篇文章开头都写明包版本和验证日期，代码在固定版本的环境里运行，输出原样放进页面，文末附有复现命令。
现在以 Python 还是 JavaScript 为主？
目前以 Python 为主。JS/TS 开发者可以看下方的 JS/TS 中文文档，但它基于更早的版本，不覆盖 v1。