Optymalizacja wydajności

Pracujesz nad monorepo z 400 000 linii kodu w 12 pakietach. Cursor potrzebuje 30 sekund, zanim zacznie sugerować uzupełnienia. Tryb Agent wstrzymuje się na 10 sekund, zanim zacznie przeglądać pliki. Wskaźnik indeksowania kręci się od godziny. Zaczynasz się zastanawiać, czy Cursor po prostu nie działa w dużych projektach.

Działa. Ale duże projekty wymagają dostrojenia. Domyślnie Cursor indeksuje wszystko, ładuje każde rozszerzenie i używa domyślnych limitów pamięci zaprojektowanych dla małych projektów. Kilka celowanych zmian robi różnicę między powolnym doświadczeniem a natychmiastowymi odpowiedziami.

Czego się nauczysz

Konfigurację .cursorignore eliminującą szum indeksowania
Ustawienia pamięci i wydajności dostrojone dla dużych baz kodu
Techniki audytu rozszerzeń do identyfikowania i wyłączania rozszerzeń pochłaniających zasoby
Strategie redukcji narzutu kontekstowego bez utraty jakości AI

Najpierw napraw indeksowanie

Indeksowanie jest zwykle głównym wąskim gardłem wydajności. Wyszukiwanie semantyczne Cursora indeksuje każdy plik, który widzi. W projekcie z 50 000 plików (wliczając node_modules, wyniki budowania i wygenerowany kod) większość indeksu to szum.

Plik .cursorignore

Utwórz plik .cursorignore w katalogu głównym projektu. Działa jak .gitignore, ale kontroluje konkretnie to, co Cursor indeksuje i przeszukuje:

Gotowy .cursorignore do skopiowania dla projektów JavaScript/TypeScript:

# Build artifacts
dist/
build/
.next/
out/
.nuxt/
.output/

# Large dependency tree -- exclude from indexing
# (Cursor already ignores node_modules by default; this is belt-and-suspenders)
node_modules/

# Generated code
__generated__/
*.generated.ts
*.d.ts.map
*.js.map
coverage/

# Large assets
*.min.js
*.min.css
*.bundle.js
public/assets/
static/media/

# Package manager
.pnpm-store/
.yarn/

# IDE and OS
.git/
.DS_Store
*.log

Dla projektów Python dodatkowo wyklucz:

.venv/
venv/
__pycache__/
*.pyc
.mypy_cache/
.pytest_cache/
htmlcov/
*.egg-info/

Weryfikacja statusu indeksowania

Otwórz Cursor Settings > Indexing & Docs i sprawdź status Codebase Indexing. Jeśli pokazuje dużą liczbę indeksowanych plików, twój .cursorignore nie jest wystarczająco agresywny. Po aktualizacji pliku ignorowania wymuś świeży przebieg przyciskiem Resync Index w tym miejscu (lub poprzez paletę poleceń, jeśli twoja wersja udostępnia polecenie ponownego indeksowania).

Optymalizacja obciążenia rozszerzeniami

Rozszerzenia to drugi co do wielkości czynnik obniżający wydajność. Każde zainstalowane rozszerzenie VS Code działa wewnątrz Cursora i konkuruje o pamięć i CPU.

Audyt rozszerzeń

Otwórz panel Rozszerzenia (Cmd/Ctrl+Shift+X)
Posortuj według “Installed”
Dla każdego rozszerzenia zadaj pytanie: “Czy używam tego co tydzień?”
Wyłącz rozszerzenia, których aktywnie nie używasz
Zwróć szczególną uwagę na rozszerzenia uruchamiające serwery językowe (Python, Java, C++)

Rozszerzenia o dużym wpływie do przeglądu

Te kategorie rozszerzeń zazwyczaj zużywają znaczne zasoby:

Serwery językowe dla języków, których nie używasz — Jeśli pracujesz w projekcie TypeScript, wyłącz rozszerzenia Java, Python i C++
Rozszerzenia lintujące duplikujące wbudowane możliwości Cursora
Rozszerzenia wizualizacji git ze śledzeniem plików w czasie rzeczywistym
Rozszerzenia formatowania kodu uruchamiające się przy każdym zapisie

Profile rozszerzeń specyficzne dla workspace

Użyj ustawień workspace Cursora, aby włączać rozszerzenia tylko tam, gdzie są potrzebne:

{
  "extensions.autoUpdate": false,
  "extensions.ignoreRecommendations": true
}

Możesz również wyłączyć konkretne rozszerzenia dla danego workspace za pomocą przełącznika workspace w panelu Rozszerzenia.

Ustawienia pamięci i edytora

Zwiększenie alokacji pamięci

Dla dużych projektów Cursor może potrzebować więcej pamięci niż domyślna alokacja. Dodaj te ustawienia do settings.json:

{
  "files.maxMemoryForLargeFilesMB": 4096,
  "search.maxResults": 20000,
  "editor.maxTokenizationLineLength": 20000
}

Redukcja obciążenia obserwatorami plików

W dużych projektach obserwatorzy systemu plików zużywają znaczne zasoby:

{
  "files.watcherExclude": {
    "**/node_modules/**": true,
    "**/dist/**": true,
    "**/build/**": true,
    "**/.git/objects/**": true,
    "**/.git/subtree-cache/**": true,
    "**/coverage/**": true
  }
}

Optymalizacja wyszukiwania

Wyklucz te same katalogi z wbudowanego wyszukiwania VS Code:

{
  "search.exclude": {
    "**/node_modules": true,
    "**/dist": true,
    "**/build": true,
    "**/coverage": true,
    "**/*.min.js": true,
    "**/*.map": true
  }
}

Wydajność uzupełniania Tab

Jeśli uzupełnianie Tab wydaje się wolne, te ustawienia pomogą:

{
  "editor.quickSuggestions": {
    "other": true,
    "comments": false,
    "strings": true
  },
  "editor.suggestOnTriggerCharacters": true,
  "editor.acceptSuggestionOnCommitCharacter": false
}

Wydajność worktree

Jeśli używasz równoległych agentów z worktree, zoptymalizuj inicjalizację. Ta konfiguracja żyje we własnym pliku — .cursor/worktrees.json — nie w settings.json. Czytelnik, który wklei ją do settings.json, zobaczy, że jest po cichu ignorowana.

Zedytuj .cursor/worktrees.json:

{
  "setup-worktree": [
    "pnpm install --frozen-lockfile",
    "cp $ROOT_WORKTREE_PATH/.env .env"
  ]
}

Forma tablicy poleceń uruchamia każde polecenie sekwencyjnie w nowym worktree, a $ROOT_WORKTREE_PATH wskazuje z powrotem na twoje główne drzewo robocze (przydatne do kopiowania nieśledzonych plików takich jak .env). Używaj pnpm, bun lub uv zamiast npm install — są znacznie szybsze przy inicjalizacji worktree, ponieważ wykorzystują globalny cache pakietów. Cursor odradza dowiązywanie symboliczne zależności do worktree, ponieważ może to uszkodzić główny worktree.

Klucze czyszczenia są natomiast naprawdę kluczami settings.json (i wymagają Cursora 2.1 lub nowszego). Każdy workspace dopuszcza maksymalnie 20 worktree; ustawienie niższego limitu szybciej odzyskuje miejsce na dysku:

{
  // tylko 2.1 i nowsze
  "cursor.worktreeCleanupIntervalHours": 6,
  "cursor.worktreeMaxCount": 10
}

Prompt do skopiowania — identyfikacja wąskich gardeł wydajności:

Użyj trybu Ask:

Analyze this project's structure and tell me:
1. How many files are in each top-level directory (approximate count)
2. Which directories contain generated or build output that should be in .cursorignore
3. Which directories have the most files that are unlikely to need AI indexing
4. Are there any unusually large files (over 5000 lines) that might slow down context loading

I want to optimize Cursor's performance for this project.

Kiedy coś nie działa

Indeksowanie nadal wolne po zmianach w .cursorignore. Przeindeksuj jawnie przez paletę poleceń. Zmiany w pliku ignorowania mogą nie zadziałać do następnego pełnego przeindeksowania.

Uzupełnianie Tab całkowicie znika. Sprawdź, czy nie wyłączyłeś serwera języka TypeScript. Zweryfikuj również, czy twój projekt ma poprawny tsconfig.json — uzupełnianie Tab opiera się na serwisie języka TypeScript.

Odpowiedzi agenta są wolne, ale indeksowanie jest w porządku. Wąskim gardłem może być opóźnienie sieciowe do modelu AI, a nie lokalna wydajność. Spróbuj innego modelu (Claude Sonnet 4.6 jest szybszy niż Claude Opus 4.8) lub sprawdź swoje połączenie internetowe.

Worktree pochłaniają miejsce na dysku. Zmniejsz wartości cursor.worktreeMaxCount i cursor.worktreeCleanupIntervalHours w ustawieniach. Uruchom git worktree list, aby zobaczyć wszystkie aktywne worktree i git worktree prune, aby wyczyścić przestarzałe.

Co dalej

Strategie dla dużych baz kodu — Wydajność jest fundamentem workflow dla dużych projektów
Zarządzanie tokenami — Redukcja narzutu kontekstowego poprawia też szybkość odpowiedzi
Niestandardowe reguły i szablony — Dobrze dobrane reguły zmniejszają przestrzeń wyszukiwania agenta