[实战指南] 如何用 Cursor 高效理解陌生代码库

"核心目标\x0a利用 Cursor 辅助，快速、深入地掌握一个新项目的代码架构、技术栈和业务逻辑，并生成可供反复查阅的文档。 \x0a \x0a详细工作流归纳\x0a1. 安全探索与全局扫描 (准备阶段)\x0a开启“Ask Mode”：\x0a· 操作：将 Cursor 切换至 Ask Mode\x0a· 目的：这是一个只读模式，防止在探索过程中意外修改代码，确保代码库的安全\x0a快速检索：\x0a· 操作：选择速度较快的模型 Composer 1，让其 grep 整个代码库及关键子文件夹\x0a· 目的：通过快速扫描，让 AI 对项目有一个宏观的初步认知\x0a\x0a2. 制定学习蓝图 (规划阶段)\x0a生成理解计划：\x0a· 操作：切换至 Plan Mode\x0a· 指令：要求 AI 创建一个“如何理解该代码库”的计划\x0a· 内容重心：从技术集成开始，逐步过渡到文件目录结构\x0a· 目的：不盲目阅读代码，而是让 AI 帮你规划一条逻辑清晰的学习路径\x0a\x0a3. 自动化文档生成 (执行阶段) \x0a深度索引与拆解：\x0a· 操作：将上一步的计划保存为 Markdown 文件，切换至 Agent Mode，并选用强大模型\x0a· 指令：让 Agent 索引全库，并开始将代码库拆解为多个 Markdown 文档\x0a文档分类：\x0a· Frontend\x0a· Backend\x0a· User Journey\x0a· Technical Breakdown\x0a\x0a4. 可视化辅助 (进阶阶段)\x0a复杂架构图解：\x0a· 场景：如果项目包含 Redis、微服务等复杂组件，单纯的文字描述不够直观\x0a· 操作：切换回 Claude 模型\x0a· 目的：利用 Claude 强大的上下文理解能力，生成产品工作流的架构图或流程图，辅助视觉理解\x0a\x0a5. 复盘与迭代 (内化阶段)\x0a阅读与答疑：\x0a· 操作：切换至 Preview Mode 阅读生成的文档\x0a· 循环：遇到不懂的细节，随时切回 Ask Mode 向 AI 提问\x0a· 重复：多次重复此过程，直到建立起基本的认知框架\x0a\x0a关键心得 “好记性不如烂笔头” —— 在整个过程中，不要只是被动阅读。强调要养成两个记录习惯：\x0a· 工程实现笔记：记录特定功能是如何实现的逻辑简记\x0a· 关键文件名：记录核心工作流中涉及的重要文件名称，方便日后快速定位\x0a\x0a\x26ltnull