第35篇：Vibe Coding时代：LangGraph 自动生成接口文档实战，解决代码变了文档不同步问题

一、问题场景：接口代码改了，文档还是旧的

真实开发里，接口文档不同步是高频问题。

尤其在 Vibe Coding 场景下，Agent 可能快速生成或修改接口：

新增 /login 修改 /users 调整响应结构 补充错误码 修改鉴权方式

代码变得很快，但文档往往没跟上。

结果就是：

1. 前端按旧文档联调失败 2. 测试不知道新字段 3. 产品看不到接口变化 4. 后端自己也忘了改了什么 5. 接口响应格式和文档不一致

本文解决的问题是：

如何用 LangGraph 读取 FastAPI 代码，自动生成接口文档，并在代码修改后保持文档同步。

二、接口文档 Agent 的目标

我们要实现：

读取代码文件 ↓ 分析 API 路由 ↓ 生成 Markdown 接口文档 ↓ 写入 docs/api.md ↓ 输出文档摘要

生成文档应包