[實戰指南] 如何用Cursor 高效理解陌生程式碼庫：結構化工作流程、透過切換不同的模式和模型，將複雜的程式碼庫拆解為易於消化的文檔 核心目標利用AI 輔助，快速、深入地掌握一個新專案的程式碼架構、技術堆疊和業務邏輯，並產生可供重複查閱的文件。 詳細工作流程解讀將理解程式碼的過程分為了七個清晰的步驟，我們把它歸納為以下幾個階段： 1. 安全探索與全域掃描(準備階段) 開啟“Ask Mode”： · 操作：將Cursor 切換至Ask Mode。 · 目的：這是一個唯讀模式，防止在探索過程中意外修改程式碼，確保程式碼庫的安全。 快速檢索： · 操作：選擇速度較快的模型Composer 1，讓其掃描（grep）整個程式碼庫及關鍵子資料夾。 · 目的：透過快速掃描，讓AI 對項目有一個宏觀的初步認知。 2. 制定學習藍圖(規劃階段) 生成理解計劃： · 操作：切換至Plan Mode。 · 指令：請AI 建立一個「如何理解該程式碼庫」的計畫。 · 內容重心：從技術整合（如Resend, AI SDK 等第三方函式庫）開始，逐步過渡到文件目錄結構。 · 目的：不盲目閱讀程式碼，而是讓AI 幫你規劃一條邏輯清晰的學習路徑。 3. 自動化文件產生(執行階段) 深度索引與拆解： · 操作：將上一個步驟的計畫儲存為Markdown 文件，切換至Agent Mode，並選用強大的模型。 · 指令：讓Agent 索引全庫，並開始將程式碼庫拆解為多個Markdown 文件。 文件分類： · Frontend（前端架構） · Backend（後端架構） · User Journey（使用者旅程/業務流程） · Technical Breakdown（技術細節拆解） 4. 可視化輔助(進階階段) 複雜架構圖解： · 場景：如果項目包含Redis、微服務等複雜元件，單純的文字描述不夠直觀。 · 操作：切換回Claude 模型。 · 目的：利用Claude 強大的情境理解能力，產生產品工作流程的架構圖或流程圖，輔助視覺理解。 5. 複盤與迭代(內化階段) 閱讀與答疑： · 操作：切換至Preview Mode 閱讀產生的文件。 · 循環：遇到不懂的細節，隨時切回Ask Mode 向AI 提問。 · 重複：多次重複此過程，直到建立起基本的認知架構。 💡 關鍵心得「好記性不如爛筆頭」 —— 在整個過程中，不要只是被動閱讀。強調要養成兩個記錄習慣： · 工程實作筆記：記錄特定功能是如何實現的邏輯簡記。 · 關鍵檔案名稱：記錄核心工作流程中涉及的重要檔案名稱，方便日後快速定位。 這套方法的精髓在於「分而治之」和「以寫代讀」。它沒有讓你直接一頭栽進程式碼海裡，而是先利用AI 的規劃能力產生規劃，再利用AI 的執行能力產生說明書，最後透過針對性的圖解攻克難點。
![[實戰指南] 如何用Cursor 高效理解陌生程式碼庫：結構化工作流程、透過切換不同的模式和模型，將複雜的程式碼庫拆解為易於消化的文檔
核心目標利用AI 輔助，快速、深入地掌握一個新專案的程式碼架構、技術堆疊和業務邏輯，並產生可供重複查閱](https://pbs.twimg.com/media/G7aL_o8aAAAqkNa.jpg)