作为每天写业务代码、修线上问题、参加评审的后端或全栈开发，你可能也有同感：真正写代码的时间常被排查问题、写文档和同步进度挤占，很多重复性的文字和样板代码其实可以交给 AI 起草。长文档的问题是读不完也记不住，AI 可以先帮你抓结构和重点，你再决定哪里值得精读。这篇文章用一个完整的例子演示程序员如何借助 AI 总结长文档：把文档上传给支持长文本的 AI，先要结构化摘要，再针对关心的问题追问并要求标注原文位置。

典型场景

程序员经常收到几十页的材料：制度文件、行业报告、技术方案文档或者对方发来的方案。技术负责人要求明天给出意见，逐字读完时间不够，只看开头又怕漏掉关键条款。尤其当技术负责人同时还在等“补齐用户模块的单元测试”的结果时，能把这部分工作提速，就能腾出精力处理更重要的判断。

工具选择

选择支持长文本或文件上传的工具，例如 Kimi、ChatGPT、Claude、通义千问、豆包等；内部敏感文件优先使用公司部署的 AI 或带权限管控的知识库工具。

案例：一次完整的使用过程（虚构）

先看一个虚构但很典型的例子。小吴是一位每天写业务代码、修线上问题、参加评审的后端或全栈开发，这周手头的事情包括“完成订单服务接口重构，接口平均响应从约 300ms 降到 120ms 左右（以压测为准）”和“整理缓存方案技术文档”，偏偏这时又需要总结长文档。小吴没有从空白页开始，而是先花几分钟把相关材料整理好，按下面的提示词交给 AI，拿到初稿后对照原始资料逐条核对，再补上自己的判断。整个过程中，小吴特别留意不把密钥、内网地址、数据库连接串和用户数据放进对话里。

分步操作

  1. 确认文档可以上传（不含未授权的密钥、内网地址、数据库连接串和用户数据）
  2. 针对你关心的问题逐个追问，要求引用原文页码或段落
  3. 让 AI 列出文档中的数字、日期和义务性条款
  4. 对关键结论回到原文核对

提示词模板（可直接复制）

提示词的关键是把背景、要求和输出格式写清楚：

【背景】最近在处理“完成订单服务接口重构，接口平均响应从约 300ms 降到 120ms 左右（以压测为准）”，同时要准备“整理缓存方案技术文档”。
我是程序员，上传的文件是一份与“订单服务从单体拆分为微服务”相关的材料。
请帮我：

1. 用 5 句话概括文档的核心内容
2. 列出文档结构（章节和每章一句话要点）
3. 提取所有涉及时间节点、数字、责任分工的内容，用表格展示，并注明出处页码
4. 从程序员的角度，指出 3 个需要重点关注或可能有风险的地方
5. 文档中没有说清楚的问题，单独列出

只依据文档内容回答，文档没有的信息请明确说“文档未提及”。

AI 输出示例（示意）

下面是演示用的输出示例，其中的人名、数字和事项均为虚构，实际使用时请以你自己的资料为准：

核心内容：文档围绕“订单服务从单体拆分为微服务”提出了分阶段的实施方案，明确了各方职责和时间安排……（共 5 句）

关键信息表

内容要点出处
时间节点第一阶段需在季度末完成第 4 页
责任分工由程序员所在团队牵头第 6 页

需要关注

  1. 第 6 页的职责划分与当前实际分工不一致
  2. 文档没有提及“依赖的第三方支付 SDK 下周升级，可能需要适配”这类风险的应对
  3. 验收标准描述较模糊

文档未说清楚：预算来源、延期处理方式

注意示例中所有内容都是虚构的。实际使用时，AI 的输出质量取决于你提供的材料是否完整、要求是否具体。

注意事项与技巧

  • 扫描版 PDF 先做 OCR，否则 AI 可能读不到内容。
  • 对“文档未提及”的内容保持警惕，AI 有时会用常识补全。

给程序员的特别提醒

让 AI 先解释思路再给代码，便于你判断方向对不对。同时要记住：AI 生成的代码必须经过本地运行、测试和代码评审，不要直接合入主干。

再补充一条经验：把报错堆栈、相关代码片段和运行环境版本一起贴给 AI，比只描述现象有效得多。

变体用法

  • 两份文档对比：让 AI 列出新旧版本的差异。
  • 转成行动项：从文档中提取你需要完成的事项和截止时间。

相关阅读