我們團隊有同事在使用 Cursor 處理大型 monorepo 或資料分析專案時,發現 IDE 開始變得卡頓,出現以下狀況:
- 啟動變慢,載入 Workspace 花很久
- 滑鼠操作延遲,跳轉/補全功能不穩
- 問 AI 問題時明顯 lag
- 系統 CPU / 記憶體使用飆高
其實這些問題,多半來自一個被忽略的小東西:沒有設定 .cursorignore。
🧩 .cursorignore
是什麼?
.cursorignore
就像 .gitignore
一樣,是放在專案根目錄的設定檔,用來告訴 Cursor:
哪些檔案或資料夾不需要載入、索引或提供 AI 分析。
這可以大幅減少系統負擔,避免浪費資源在「你根本不在乎的檔案」上。
🛠 如何設定 .cursorignore
?
第一步:在專案根目錄建立 .cursorignore
touch .cursorignore
第二步:加入以下建議設定
# 相依與環境資料夾
node_modules/
.venv/
.env/
__pycache__/
# Build / 輸出檔
dist/
build/
out/
# Python 中介檔
*.pyc
# 測試快照 / coverage
coverage/
*.snap
.nyc_output/
# 大型靜態資料
*.csv
*.tsv
*.log
*.json
*.sqlite
*.db
*.zip
# 可選的資料夾
public/
data/
這些設定可以避免 Cursor 去載入成千上萬個不必要的檔案。
✨ 小技巧:請 Cursor 幫你產生 .cursorignore
其實 Cursor 本身就有內建 AI,可以根據你的專案結構主動建議應該忽略的項目。
✅ 使用方式:
打開 Cursor 輸入並執行以下 Prompt:
幫我依照這個專案產生一個 .cursorignore 設定檔案
Cursor 會根據你的專案結構自動產生 .cursorignore 建議,顯示在側邊編輯器中供你套用或微調。
🧪 使用建議:
- 特別適合剛 clone 下來的新專案,或接手別人維護的 codebase
- 避免忘記忽略 .next/、.turbo/、dataset/ 等資料夾
- 可搭配手動編輯 .cursorignore,達到最佳排除效果
✅ 設定後的改善效果
只要設定好 .cursorignore
,並重新載入 Workspace,你會明顯感受到:
- 🚀 啟動速度變快
- 🤖 問 AI 回應速度變快
- 💻 記憶體/CPU 使用降低
- 🧠 AI 建議更準確(少了多餘干擾資料)
🧪 延伸建議與實用技巧
- .cursorignore 語法與 .gitignore 相同,支援萬用字元與資料夾排除
- monorepo 架構建議「每個子資料夾」也加 .cursorignore
- 可加註註解提醒其他開發者,例如:
# 資料訓練集太大,排除
data/raw/
- 團隊開發建議把 .cursorignore 一起 commit 到 Git,確保所有人都有一致體驗
🧭 結語
Cursor 是一套強大的 AI 編輯器,但它再聰明,也需要你幫它「聚焦」。
透過 .cursorignore
,可以讓 AI 專注在重要邏輯上,也讓你的筆電喘口氣。
別再讓它幫你讀 node_modules
或 data.csv
了 😅
📌 如果你覺得這篇文章有幫助,歡迎分享給使用 Cursor 的朋友或同事!
💬 如果你有 .cursorignore
的額外技巧,歡迎留言一起交流!
✏️ 本文內容來自我自己在使用 Cursor 時的實戰經驗,之後還會分享更多效能優化與開發環境整理的技巧,歡迎追蹤 🙌