官方教程那么好， 我为什么还是不会用

AI+工作日更 · 第一讲

官方教程那么好， 我为什么还是不会用

最近想写一个LangChain的教程。

打开官方文档看了一圈，我放弃了。不是那种"我再想想"的放弃，是那种"算了"的放弃。

不是因为官方写得差——恰恰相反，它写得太好了。Models、Prompts、Chains、Tools、Agents，核心组件基本全覆盖，知识点该有的都有。你想到的它有，你没想到的它也有。

那我写什么？

"我会了"和"我会用了"之间，有一道缝。

而官方教程越完美，这道缝藏得越深。

后来我想了想，这事儿可能不只是"我没东西可写"的问题。

你有没有过这种感觉——看完一篇教程，觉得每个字都看懂了，每个API都认识了，甚至能跟人聊两句原理。然后打开自己的项目，对着屏幕发呆。

那种发呆不是"我忘了"，是"我知道该用哪个工具，但不知道该怎么用"。

📌 这道缝叫业务判断

教程教你的是Happy Path——数据干净、需求明确、答案唯一。你照着敲，跑通了，觉得自己会了。

你肯定也有过这种时刻——教程跑通了，觉得自己会了，然后第一个真实需求就给你一巴掌。

真实项目里没有Happy Path。你的用户输入是乱七八糟的，你的业务逻辑是互相矛盾的，你的数据源是三个不同格式的烂摊子。教程里的Output Parser教你的是标准场景下的解析，但没人告诉你——用户给你的是A+乱码+emoji，业务要的是C，而你手里只有一套给B设计的流程。

格式漂移了怎么办？业务语义需要二次转换怎么办？三个数据源要适配同一个解析器怎么办？这些，官方文档不会针对你的业务来写。不是它不想写，是它不知道你的业务长什么样。

其实不只是LangChain。你学任何一个AI工具，看完教程觉得自己会了，但那种"会"更像是在简历上打了个勾——RAG ✓，Agent ✓，Prompt Engineering ✓。勾打完了，感觉掌握了先进生产力。但真到用的时候，勾再多也没用，因为勾不住真实业务。

📌 写踩坑，不写知识点

所以回到开头那个问题——我还写不写那个教程？

写。但不是写知识点，是写踩坑。写那些官方不会告诉你的、只有真实项目里才会遇到的东西。

这可能也是AI时代内容输出最有价值的方向之一——当官方文档和AI本身把基础知识都覆盖了，"我会了"的门槛已经被压到极低，那"我会用了"和"我会了"之间的差距反而被拉大了。谁能帮你填上这道缝，谁才有用。

这不是教程的错，这是教程的边界。

知道边界在哪，比多看十篇教程有用。

工位旁的清醒人 · AI+工作日更