Cursor 會為每個檔案計算 embedding 來為程式碼庫建立索引,讓關於你程式碼的 AI 回答更準確。當你開啟專案時,Cursor 會自動開始索引;新檔案會逐步增量索引。 在這裡查看索引狀態:Cursor Settings > Indexing & Docs
程式碼庫索引進度指示器

設定

Cursor 會為所有檔案建立索引,但會排除 忽略檔案(例如 .gitignore.cursorignore)中指定的檔案。 點選 Show Settings 以:
  • 啟用新存放庫的自動索引
  • 設定要忽略的檔案
忽略大型內容檔案 有助提升回答準確度。

檢視已索引的檔案

若要查看已索引的檔案路徑:Cursor Settings > Indexing & Docs > View included files 這會開啟一個列出所有已索引檔案的 .txt 檔案。

多根工作區

Cursor 支援 多根工作區,讓你同時處理多個程式碼庫:
  • 所有程式碼庫都會自動建立索引
  • 每個程式碼庫的上下文都可供 AI 使用
  • .cursor/rules 可在所有資料夾中運作
PR 搜尋透過讓歷史變更可被 AI 搜尋與存取,幫你理解程式碼庫的演進。

運作方式

Cursor 會自動從你的儲存庫歷史中索引所有已合併的 PR。摘要會出現在語意搜尋結果中,並透過智慧篩選優先顯示最近的變更。 Agent 可以使用 @[PR number]@[commit hash]@[branch name] 將**PR、提交(commit)、議題(issue)、或分支(branch)**帶入上下文。連線後也會包含 GitHub 留言與 Bugbot 審查。 平台支援包括 GitHub、GitHub Enterprise,以及 Bitbucket。目前不支援 GitLab。
GitHub Enterprise 使用者:由於 VS Code 認證限制,抓取工具會回退為使用 git 指令。
問像是「其他 PR 裡的 services 是怎麼實作的?」這類問題,Agent 會自動把相關 PR 帶入上下文,根據你的儲存庫歷史提供完整答案。

常見問題

目前沒有全域清單。請個別開啟每個專案,在 Cursor 中查看 Codebase Indexing 設定。
從 Settings 刪除你的 Cursor 帳號即可移除所有已建立索引的程式碼庫。 否則,請到各專案的 Codebase Indexing 設定中刪除個別程式碼庫。
若 6 週未使用,已建立索引的程式碼庫會被刪除。重新開啟 專案會觸發重新索引。
不會。Cursor 只會建立嵌入向量(embeddings),不會儲存檔名或原始碼。檔名會做混淆處理,程式碼區塊會加密。當 Agent 搜尋程式碼庫時,Cursor 會從伺服器取回嵌入向量並解密這些區塊。