Cursor 快速入門 01：學習資源與核心概念解析

Cursor 作為一款 AI 驅動程式碼編輯器，結合了大型語言模型（LLM）與現代開發環境，網路上已經有很多學習資源，因為版本更動非常快，會建議直接看最新的影片

推薦學習資源

以下是一些優質的學習資源，可以幫助您快速掌握 Cursor：

• Cursor 官方文件 - 最權威的參考資料
• ExplainThis.io - Cursor 中文教學 - 完整的中文指南
• How I reduced 90% errors for my Cursor - 進階使用taskmaster
• Cursor 新功能、新技巧、新玩法｜0.44-0.50 - 1hr 詳細介紹 中文

核心概念解析

1. Agent 模式

Agent 模式是 Cursor 的核心功能之一，具備以下特點：

• 自主操作：能夠獨立探索整個 Codebase，識別相關文件，並進行必要的修改
• 全面工具存取：可使用所有可用工具來搜索、編輯、創建文件，並運行終端命令
• 上下文理解：建立對項目結構和依賴關係的全面理解
• 多步驟規劃：將複雜任務分解為可管理的步驟，並依序執行

🔔 重要提醒：預設情況下，每次 Agent 請求最多可進行 25 次工具調用。超過此限制時，Cursor 會提示是否繼續，並消耗第二次請求。

ask和manual 模式問一次也是算一次請求,agent 模式明顯划算的多

2. 模型選擇和 Max Mode

💡 提示：有大腦圖標的是推理模型（如 claude-3.7-sonnet），使用時會消耗兩倍的請求次數。

Max Mode 特點

Max Mode 提供了更強大的功能：

• 更大的上下文窗口：可處理更多的代碼內容
• 更強的推理能力：適合需要深入理解和分析的任務
• 基於 token 的計費：不計入標準的 500 次限制，而是單獨計費

重要區別：

• 一般模式：read_file 工具一次最多讀取 250 行程式碼
• Max Mode：read_file 工具一次最多讀取 750 行程式碼，且最多可使用 200 個工具調用

🎯 大部分情況 Max 模式≠解決問題提升。

Max mode等於= 容納更多清楚資訊 . 一次agent request 處理更長內容 ,更多次修改

3. Codebase Indexing：提升 AI 理解能力

Cursor 通過索引（Indexing）來提升 AI 的理解能力：

• 自動索引：
  • 打開項目時自動初始化索引
  • 新增文件時自動更新索引
• 選擇性索引：
  • 可通過 .gitignore 或 .cursorignore 排除不需要的文件
  • 提升索引效率和準確性 索引狀態可在 Cursor Settings > Features > Codebase Indexing 中查看。

💡 運作原理：Cursor 使用類似 RAG（檢索增強生成）的方法，通過索引記住專案文件大綱，需要時檢索相關資料並提供給 AI 模型整合回答。

💡可以簡單理解為:

• Cursor根據使用者問題=>查找index⇒多次查找資料⇒資料自動貼到AI model ⇒統整後 ⇒回答

4. 常見限制與除錯技巧

使用 Cursor 時可能遇到的限制和解決方案：

🔧 進階提示：遇到複雜問題時，可以考慮切換到 Max Mode，但要注意額外的 token 消耗。

相關資源

• Cursor 官方文件
• Cursor Settings > Features > Codebase Indexing