Podstawowe Funkcje: Wskazówki 16-30

Masz zainstalowany i skonfigurowany Cursor. Tryb Auto-Run jest włączony, reguły projektu są zacommitowane, indeksowanie jest zakończone. Ale nadal używasz Cursora jak VS Code z panelem bocznym chatu – ręcznie wpisujesz kod, ręcznie uruchamiasz polecenia i od czasu do czasu zadajesz AI pytanie. To jak kupienie sportowego samochodu i jeżdżenie nim tylko na pierwszym biegu. Te 15 wskazówek obejmuje funkcje, które sprawiają, że Cursor jest fundamentalnie inny od zwykłego edytora kodu.

Co Wyniesiesz z Tego Rozdziału

Trzy skróty klawiszowe, które obsługują 80% Twoich interakcji z AI (Tab, Cmd+K, Cmd+I)
Polecenia AI terminala, które eliminują zapamiętywanie niejasnych flag CLI
Techniki nawigacji, które pozwalają przejść do dowolnego symbolu, pliku lub koncepcji w sekundy
Przepływ pracy wiadomości commit, który pisze się sam
Jak Bugbot przegląda Twoje pull requesty i wyłapuje błędy, zanim zrobi to recenzent będący człowiekiem

Trzy Skróty, Które Mają Największe Znaczenie

Wskazówka 16: Opanuj Klawisz Tab dla Uzupełnień AI

Tab w Cursorze to nie zwykłe autouzupełnianie. To wieloliniowa, kontekstowa predykcja, która rozumie strukturę Twojego projektu. Kluczowe zachowania do zinternalizowania:

Pojedynczy Tab: Zaakceptuj pełną sugestię
Escape: Odrzuć bieżącą sugestię
Alt+] / Alt+[: Przełączaj się między alternatywnymi sugestiami
Tab po Tab: Cursor czasami łączy sugestie – po zaakceptowaniu jednej natychmiast oferuje następną logiczną edycję

Myląca część dla nowych użytkowników polega na tym, że „Tab” czasami uzupełnia kod, a czasami przenosi Cię do następnej lokalizacji edycji. To jest zamierzone. Cursor przewiduje nie tylko co wpiszesz, ale gdzie będziesz pisał dalej. Zaufaj przepływowi, a znajdziesz się nawigującym przez łańcuch powiązanych edycji bez dotykania myszy.

Wskazówka 17: Używaj Cmd+K dla Ukierunkowanych Edycji Jednoplikowych

Cmd+K (macOS) lub Ctrl+K (Windows/Linux) otwiera tryb edycji inline. Jego zachowanie zmienia się w zależności od kontekstu:

Z zaznaczonym kodem: Przepisuje zaznaczenie na podstawie Twojej instrukcji
Z kursorem na pustej linii: Generuje nowy kod w tej pozycji
Z kursorem wewnątrz funkcji: Rozumie otaczający kontekst dla bardziej precyzyjnych edycji

Kluczową zaletą nad trybem agenta jest szybkość. Cmd+K wie, że musi tylko zmodyfikować zaznaczony kod, więc reaguje szybciej i z większą precyzją. Używaj go do chirurgicznych edycji, gdzie możesz wskazać dokładnie, co wymaga zmiany.

Wskazówka 18: Używaj Cmd+I do Otwarcia Panelu Agenta

Cmd+I (macOS) lub Ctrl+I (Windows/Linux) otwiera panel agenta/chatu. Jeśli masz zaznaczony kod, gdy go naciskasz, ten kod jest automatycznie dołączany jako kontekst. To punkt wejścia dla operacji wieloplikowych.

Dostępne są cztery tryby, między którymi przełączasz się za pomocą Shift+Tab (lub rozwijanej listy trybów):

Agent (domyślny): Autonomiczna edycja między plikami, może uruchamiać polecenia, iterować nad błędami
Ask: Tylko do odczytu, do pytań i eksploracji bez modyfikowania plików
Plan: Bada bazę kodu, zadaje pytania doprecyzowujące i tworzy edytowalny plan, zanim go zbuduje
Debug: Generuje hipotezy i instrumentuje kod instrukcjami logującymi, aby namierzyć podstępne, trudne do odtworzenia błędy

Domyślnie używaj trybu Agent do codziennej pracy. Sięgaj po tryb Plan przy złożonych, wieloplikowych funkcjach, po tryb Ask, gdy chcesz tylko omówić kod, a po tryb Debug przy regresjach i race conditions.

Supermoce Terminala

Wskazówka 19: Używaj Cmd+K w Terminalu dla Poleceń AI

To jedna z najbardziej niedocenianych funkcji. Naciśnij Cmd+K, gdy Twój kursor jest w zintegrowanym terminalu, a Cursor daje Ci prompt AI dla poleceń terminala. Opisujesz, co chcesz po angielsku; generuje polecenie.

# Instead of remembering:
git log --oneline --graph --all --decorate -20

# Type in the Cmd+K terminal prompt:
# "show my last 20 git commits as a graph with branch names"

# Instead of looking up:
find . -name "*.ts" -not -path "*/node_modules/*" | xargs grep "TODO"

# Type:
# "find all TODO comments in TypeScript files, excluding node_modules"

To nie jest zabawkowa funkcja. Doświadczeni inżynierowie zgłaszają oszczędność 10-15 minut dziennie tylko na wyszukiwaniu poleceń. Przestań zapamiętywać flagi git i argumenty Docker CLI.

Wskazówka 20: Pozwól Agentowi Automatycznie Naprawiać Błędy Budowania

Po sesji kodowania, zamiast ręcznie polować na błędy TypeScript, pozwól agentowi to obsłużyć:

Z włączonym trybem Auto-Run (dawniej nazywanym trybem YOLO) agent uruchamia tsc, czyta błędy, naprawia je, ponownie uruchamia tsc i powtarza, aż pozostanie zero błędów. To działa z dowolnym narzędziem budowania — npm run build, cargo check, go vet, pytest.

Wskazówka 21: Utwórz Prompt Walidacji Przed PR

Zachowaj prompt wielokrotnego użytku do końcowej kontroli przed otwarciem pull requesta:

Zapisz to jako plik .md w swoim projekcie i odwołuj się do niego za pomocą @, kiedy jesteś gotowy do przesłania PR. Niektórzy programiści nazywają to swoim promptem „wyślij to”.

Nawigacja i Wyszukiwanie

Wskazówka 22: Używaj Wyszukiwania Semantycznego Zamiast Wyszukiwania Tekstowego

Wyszukiwanie Cursora rozumie znaczenie, a nie tylko ciągi znaków. W panelu agenta opisz w naturalnym języku, czego szukasz:

Where is the function that handles user authentication and generates JWT tokens?

To znajduje właściwy kod, nawet jeśli funkcja nazywa się createSession lub issueToken – terminy, których nigdy nie dopasowałbyś wyszukiwaniem tekstowym dla „authentication”.

Dla precyzji łącz wyszukiwanie semantyczne i tekstowe. Agent może uruchomić grep dla dokładnych dopasowań, używając jednocześnie swojego rozumienia dla dopasowań konceptualnych.

Wskazówka 23: Używaj Referencji @ dla Precyzyjnego Kontekstu

W każdej rozmowie z agentem wpisz @, aby odwołać się do konkretnego kontekstu:

@Files & Folders — Dołącz konkretny plik lub cały katalog (wpisz @, a potem nazwę)
@Code — Odwołaj się do precyzyjnej funkcji, klasy lub fragmentu zamiast całego pliku
@Docs — Odwołaj się do zaindeksowanej dokumentacji (wbudowanych bibliotek lub własnej dodanej dokumentacji)
@Past Chats — Wciągnij kontekst z wcześniejszej rozmowy

Im bardziej konkretny Twój kontekst, tym dokładniejsza odpowiedź. Zamiast „fix the auth bug”, spróbuj „fix the auth bug in @src/middleware/auth.ts — the token validation on line 42 is not checking expiration.”

Dla kontekstu z sieci i z git nie dołączasz już tokenu. Cursor 2.0 usunął jawne wzmianki @Web i @Git; agent samodzielnie zbiera teraz oba na podstawie poleceń w języku naturalnym – poproś go, aby „search the web for the latest tRPC v11 router syntax” albo „review the changes on my branch”, a sam pobierze dokumentację lub uruchomi git.

Wskazówka 24: Nawiguj za Pomocą Go To Symbol

Cmd+Shift+O otwiera Go To Symbol w bieżącym pliku. Z poziomu edytora Cmd+T otwiera Go To Symbol w całej przestrzeni roboczej – standardowy skrót VS Code, który działa identycznie w Cursorze i jest szybszy niż przewijanie lub wyszukiwanie, gdy znasz nazwę tego, czego szukasz. Jeden haczyk: gdy fokus jest w polu chatu, Cmd+T otwiera zamiast tego nową kartę chatu, więc uruchamiaj wyszukiwanie symboli z panelu edytora.

Wskazówka 25: Używaj Quick Open do Przeskakiwania Między Plikami

Cmd+P otwiera Quick Open, najszybszy sposób na przełączanie plików. Zacznij wpisywać nazwę pliku, a fuzzy-dopasuje natychmiast. Dodaj : po którym następuje numer linii, aby przejść bezpośrednio do konkretnej linii: Cmd+P następnie auth.ts:42.

Bezpieczeństwo i Kontrola Wersji

Wskazówka 26: Zrozum System Punktów Kontrolnych

Za każdym razem, gdy agent wprowadza zmiany, Cursor tworzy automatyczny punkt kontrolny. To Twoja siatka bezpieczeństwa dla agresywnych eksperymentów. Jeśli agent zbacza z kursu:

Spójrz na wskaźnik punktu kontrolnego w panelu agenta
Kliknij „Restore” na dowolnym poprzednim punkcie kontrolnym, aby cofnąć wszystkie zmiany od tego momentu
Dostosuj swój prompt i spróbuj ponownie ze znanego dobrego stanu

Punkty kontrolne są szybsze i bardziej szczegółowe niż git stash czy git checkout. Używaj ich swobodnie. Zmiana mentalna jest ważna: z punktami kontrolnymi możesz powiedzieć agentowi „spróbuj tego ryzykownego podejścia”, wiedząc, że możesz to cofnąć jednym kliknięciem.

Wskazówka 27: Generuj Wiadomości Commit Automatycznie

W panelu Source Control (panel boczny git) kliknij ikonę iskry obok pola wiadomości commit. Cursor czyta Twoje przygotowane zmiany i generuje wiadomość commit. Nie zawsze jest idealna, ale to solidny punkt wyjścia, który możesz edytować w 5 sekund zamiast pisać od zera.

Dla lepszych wyników przygotowuj zmiany przyrostowo (mniejsze, skupione commity) zamiast przygotowywać wszystko naraz. AI generuje lepsze wiadomości, gdy diff opowiada spójną historię.

Wskazówka 28: Pozwól Bugbotowi Przeglądać Twoje Pull Requesty

Stare lokalne polecenie „Bug Finder” zostało zastąpione przez Bugbot, automatycznego recenzenta PR Cursora dla GitHub i GitLab. Po włączeniu na cursor.com/dashboard Bugbot przegląda każdy pull request i zostawia komentarze inline oznaczające rzeczywiste problemy:

Brakujące sprawdzenia null i nieobsłużone przypadki brzegowe
Niespójna obsługa błędów i luki w zawężaniu typów
Problemy z bezpieczeństwem i błędy off-by-one w pętlach

Każde znalezisko ma linki Fix in Cursor i Fix in Web, dzięki czemu możesz przejść prosto do poprawki. Możesz wywołać przegląd na żądanie, komentując cursor review lub bugbot run na PR, i sterować nim za pomocą reguł projektu w plikach .cursor/BUGBOT.md (zacommitowanych do repo, stosowanych per katalog). Pomyśl o tym jak o darmowym pierwszym przebiegu przeglądu kodu, zanim spojrzy na to kolega z zespołu.

Jeśli zamiast tego chcesz kontroli przed PR na swoich lokalnych zmianach, poproś agenta o przejrzenie Twojego brancha bezpośrednio albo uruchom tryb Debug dla podstępnego błędu – oba działają, zanim cokolwiek zostanie wypchnięte.

Wzorce Codziennego Przepływu Pracy

Wskazówka 29: Używaj Trybu Plan do Planowania Architektury

Przed rozpoczęciem złożonej funkcji przełącz się na tryb Plan (Shift+Tab) i pozwól Cursorowi zbadać bazę kodu, zadać pytania doprecyzowujące i stworzyć edytowalny plan, który możesz potem zbudować jednym kliknięciem. Dla lżejszego, tylko-do-odczytu przebiegu, gdy chcesz jedynie omówić podejście bez tego, by Cursor proponował budowę, sprawdza się też tryb Ask. Ten sam prompt planowania pasuje do obu trybów:

W trybie Plan klikasz, aby zbudować plan bezpośrednio; w trybie Ask rozpocznij nową rozmowę z agentem i odwołaj się do planu jako kontekstu. Tak czy inaczej, to podejście „najpierw planuj, potem buduj” przynosi dramatycznie lepsze rezultaty niż przeskoczenie prosto do implementacji.

Wskazówka 30: Używaj Obrazów jako Kontekstu dla Pracy z UI

Cursor obsługuje wejście obrazu w panelu agenta. Przeciągnij i upuść zrzut ekranu, eksport z Figma lub mockup, a agent może użyć go jako odniesienia do generowania kodu UI.

Jest to szczególnie potężne w połączeniu z plikiem .cursorrules, który określa Twój system projektowy. Agent będzie próbował mapować projekt wizualny na rzeczywiste komponenty projektu, tokeny odstępów i zmienne kolorów – a nie ogólny CSS.

Wklejaj również zrzuty ekranu błędów. Zamiast opisywać „przycisk nakłada się na kartę na mobile”, upuść zrzut ekranu i powiedz „napraw ten problem układu, używając istniejących responsywnych breakpointów projektu.”

Gdy To Się Psuje

Cmd+K generuje błędny kod: Najczęstszą przyczyną jest niewystarczający kontekst. Jeśli zaznaczysz ciało funkcji, ale funkcja zależy od importów lub typów zdefiniowanych gdzie indziej, Cmd+K nie widzi tych zależności. Rozwiązanie: dołącz odpowiednie importy w swoim zaznaczeniu lub przełącz się na tryb agenta, który może czytać cały plik.

Cmd+K terminala generuje błędne polecenie: AI nie zna konfiguracji Twojej powłoki. Jeśli generuje polecenia npm, gdy używasz pnpm, dodaj „use pnpm for all package manager commands” do swoich globalnych reguł użytkownika (Wskazówka 15).

Bugbot produkuje fałszywe alarmy: Może nadmiernie raportować celowe wzorce, takie jak celowo nieużywane zmienne lub celowe rozszerzanie typów. Traktuj jego komentarze inline jako sugestie, a nie wymagania – napraw to, co jest oczywiście poprawne, i rozwiąż szum. Zakoduj swoje celowe wzorce w pliku reguł .cursor/BUGBOT.md, aby przyszłe przeglądy przestały je oznaczać.

Przywracanie punktu kontrolnego zostawia pliki w dziwnym stanie: Jeśli przywracanie punktu kontrolnego wydaje się niekompletne, sprawdź, że wszystkie odpowiednie pliki były śledzone. Pliki, które agent utworzył (zamiast zmodyfikował), czasami wymagają ręcznego usunięcia po przywróceniu.

Co Dalej

Masz teraz podstawowy zestaw funkcji. Przejdź do Tab Autocomplete (Wskazówki 31-45), aby nauczyć się, jak przepchnąć uzupełnianie Tab z „miło mieć” do „pisze połowę mojego kodu za mnie”. Doświadczenie z tabem ulega dramatycznej poprawie, gdy zrozumiesz model predykcji i nauczysz się go prowadzić.