Keskitaso15 min

Cursor: Kontekstin hallinta

Kontekstin hallinta on yksi tärkeimmistä taidoista vibekoodauksessa. Mitä paremmin AI ymmärtää projektisi, sitä parempia tuloksia saat. Tässä oppaassa opit kontekstin hallinnan perusteet ja edistyneet tekniikat.

Edellytykset: Cursor Composer: Tehokas käyttö, Cursor: Chat vs Composer

Mitä konteksti tarkoittaa?

Konteksti on kaikki tieto, jonka AI saa käyttöönsä:

Automaattinen konteksti: - Avoimet tiedostot - Valittu koodi - .cursorrules-tiedosto - Projektin rakenne

Lisätty konteksti: - @-syntaksilla viitatut tiedostot - Raahaamalla lisätyt tiedostot - Keskusteluhistoria

Kontekstin merkitys: Enemmän relevanttia kontekstia = paremmat vastaukset Liikaa kontekstia = hitaampi ja sekavampi AI

@-syntaksi

@-syntaksi on tehokkain tapa hallita kontekstia:

Syntaksi	Toiminto
----------	----------
@filename	Lisää yksittäinen tiedosto
@folder	Lisää koko kansio
@codebase	Hae koko projektista
@docs	Hae dokumentaatiosta
@web	Hae internetistä

// Esimerkkejä:

// Yksittäinen tiedosto
"Refaktoroi @src/components/Button.tsx käyttämään Tailwindiä"

// Useita tiedostoja
"Lisää tyypit @types/user.ts mukaisesti @src/api/users.ts tiedostoon"

// Kansio
"Tarkista @src/utils kansion funktiot ja lisää virheenkäsittely"

// Codebase-haku
"@codebase Miten autentikaatio on toteutettu?"

// Dokumentaatio
"@docs React Query - miten käytän useMutation hookia?"

Vinkki: @codebase on tehokas mutta hidas - käytä kun et tiedä missä jokin on.

Tiedostojen priorisointi

AI käsittelee tiedostoja tässä järjestyksessä:

1. Valittu koodi (korkein prioriteetti) 2. @-syntaksilla viitatut 3. Aktiivinen tiedosto 4. Muut avoimet tiedostot 5. .cursorrules 6. Projektin rakenne

Käytännön vinkki: Sulje turhat tiedostot ennen promptia. Avaa vain relevantit tiedostot. Näin AI keskittyy oikeisiin asioihin.

Kontekstin optimointi

Paranna AI:n vastauksia näillä tekniikoilla:

1. Rajaa konteksti - Älä lisää koko projektia - Valitse vain relevantit tiedostot - Sulje turhat tabit

2. Näytä esimerkit - "Tee samanlainen kuin @Button.tsx" - AI oppii tyylistäsi

3. Viittaa tyyppeihin - "@types/product.ts" kertoo datan rakenteen - Vähentää arvailua

4. Käytä .cursorrules - Projektikohtaiset ohjeet - Ei tarvitse toistaa joka promptissa

Vinkki: Laatu > määrä. Pienempi, relevantti konteksti on parempi kuin suuri, sekava.

Keskusteluhistoria

Chat ja Composer muistavat keskustelun:

Hyödyt: - Voit viitata aiempiin vastauksiin - "Tee sama mutta TypeScriptillä" - AI muistaa mitä on tehty

Haitat: - Pitkä historia vie kontekstitilaa - Vanha konteksti voi sekoittaa

Milloin aloittaa uusi keskustelu: - Siirryt täysin eri aiheeseen - AI näyttää sekoavan - Haluat "puhtaan pöydän"

Uusi keskustelu: - Chat: Klikkaa "New Chat" - Composer: Sulje ja avaa uudelleen

Codebase-indeksointi

Cursor indeksoi projektisi hakua varten:

Tarkista indeksointi: 1. Avaa Cursor Settings 2. Siirry Features > Codebase Indexing 3. Katso indeksoinnin tila

Ongelmat: - "No results" @codebase haussa - Indeksointi kesken tai epäonnistunut

Ratkaisut: - Odota indeksoinnin valmistumista - Käynnistä Cursor uudelleen - Tarkista .gitignore (jätetäänkö liikaa pois?)

Ignoroitavat: - node_modules (oletuksena) - .git (oletuksena) - Voit lisätä .cursorignore-tiedostoon

Yhteenveto

@-syntaksi on tehokkain tapa lisätä kontekstia
Rajaa konteksti relevantteihin tiedostoihin
Valittu koodi on korkeimmalla prioriteetilla
Aloita uusi keskustelu kun aihe vaihtuu

Usein kysytyt kysymykset

Miksi @codebase ei löydä kaikkea?

Tarkista että indeksointi on valmis (Settings > Features > Codebase Indexing). Jotkin tiedostot voivat olla .gitignoressa.

Kuinka paljon kontekstia AI voi käsitellä?

Cursor Pro käyttää malleja joilla on suuri konteksti-ikkuna (100k+ tokenia). Käytännössä kymmeniä tiedostoja kerralla.

Seuraavaksi