Przewodniki aktualizacji Cursor

Zaktualizowałeś Cursor automatycznie podczas lunchu i teraz Twoje .cursor/rules są ignorowane, dwa rozszerzenia się nie ładują, a serwer MCP do Postgresa zamilkł — dokładnie w środku sprintu. Rozwiązaniem nie jest blokada aktualizacji; chodzi o to, by wybrać właściwy kanał, wykonać pięciominutową kontrolę przed kliknięciem „Restart to Update” i wiedzieć dokładnie, jak się wycofać, gdy aktualizacja pójdzie nie tak.

Co z tego wyniesiesz

• Decyzję, który z trzech kanałów aktualizacji Cursora (Default, Early Access, Nightly) pasuje do Twojego konta i tolerancji ryzyka
• Gotowy do wklejenia prompt, który zamienia changelog w listę zmian łamiących dla Twojej konfiguracji w konkretnej wersji
• Powtarzalną rutynę przed aktualizacją: kopia zapasowa profilu i konfiguracji .cursor/, a potem test dymny po restarcie
• Cztery metody wycofania — punkt kontrolny, reinstalacja poprzedniej wersji, import profilu i Git — uszeregowane od najszybszej do najbardziej gruntownej

Kanały aktualizacji

Cursor oferuje trzy kanały aktualizacji, z których każdy odpowiada innemu apetytowi na ryzyko kontra nowości.

Kanał domyślny (stabilny)

Kanał domyślny zapewnia dokładnie przetestowane wydania o sprawdzonej stabilności. To zalecany wybór dla:

• Pracy deweloperskiej produkcyjnej
• Środowisk zespołowych (obowiązkowy dla zespołów)
• Deweloperów unikających ryzyka
• Projektów o krytycznym znaczeniu

Charakterystyka:

• Stabilne, przetestowane wydania
• Poprawki błędów przeniesione z testów przedwydaniowych
• Domyślny dla wszystkich użytkowników
• Jedyna opcja dla kont zespołowych i Enterprise
• Trafia do użytkowników, gdy buildy Early Access i Nightly miały już czas na wyłapanie błędów

Kanał wczesnego dostępu (Early Access)

Kanał wczesnego dostępu dostarcza funkcje przedwydaniowe przed ogólnym wydaniem. Wybierz go, by:

• Wcześnie eksplorować nowe funkcje
• Zgłaszać zespołowi raporty o błędach
• Korzystać z osobistych środowisk deweloperskich
• Prowadzić projekty niekrytyczne

Charakterystyka:

• Wersje przedwydaniowe z najnowszymi funkcjami
• Mogą zawierać błędy lub problemy ze stabilnością
• Niedostępny dla kont zespołowych
• Bezpośredni kanał opinii do deweloperów Cursora

Kanał Nightly

Kanał Nightly dostarcza najświeższe wydania — codzienne buildy prosto z najnowszej pracy wewnętrznej. Niesie najwyższą zmienność z całej trójki, więc spodziewaj się niedoróbek. Wybierz go tylko do:

• Środowiska jednorazowego lub eksperymentalnego, w którym awarie nie przeszkadzają
• Odtworzenia lub weryfikacji poprawki, którą zespół właśnie wprowadził
• Składania szczegółowych raportów o całkiem nowym zachowaniu

Charakterystyka:

• Najnowsze, najczęstsze buildy przedwydaniowe
• Najwyższe prawdopodobieństwo regresji i krótko żyjących błędów
• Nie dla kont zespołowych ani biznesowych
• Najlepiej w parze ze ścisłą kontrolą wersji, by można było wycofać się natychmiast

Ograniczenia zespołowe

Konta zespołowe i Enterprise są ograniczone do kanału domyślnego, aby każdy członek korzystał z tego samego przetestowanego buildu. Early Access i Nightly są wyłącznie dla kont indywidualnych.

Konfigurowanie ustawień aktualizacji

Przełączanie kanałów aktualizacji

1. Otwórz ustawienia Cursor za pomocą Cmd+Shift+J (macOS) lub Ctrl+Shift+J (Windows/Linux).

2. Wybierz Beta na pasku bocznym.

3. Wybierz swój kanał: Default, Early Access lub Nightly.

Po przełączeniu na kanał przedwydaniowy może być konieczne ręczne sprawdzenie aktualizacji (Help → Check for Updates), aby od razu pobrać najnowszy build. Nie ma osobnego suwaka „częstotliwości aktualizacji” — to kanał jest tym ustawieniem.

Wskazówka

Zanim przełączysz maszynę kolegi z zespołu na Early Access lub Nightly, niech agent przeczyta ostatni changelog i powie Ci, co faktycznie się zmienia. Wklej to do czatu Cursora:

“Read the Cursor changelog at https://cursor.com/changelog for the last three releases. For each release, list (1) new or changed Agent/Tab behavior, (2) anything that touches .cursor/rules, .cursor/mcp.json, or settings keys, and (3) any explicitly noted breaking changes or regressions. Then tell me, in one sentence, whether Early Access looks safe for a developer who relies on the Postgres MCP server and a custom rules file.”

Konfiguracja automatycznej aktualizacji

Cursor domyślnie obsługuje aktualizacje automatycznie, ale możesz kontrolować to zachowanie:

{
  "update.mode": "manual",           // Opcje: "none", "manual", "default"
  "update.showReleaseNotes": true,   // Pokaż changelog po aktualizacjach
  "update.enableWindowsBackgroundUpdates": true
}

Lista kontrolna przed aktualizacją

Przed aktualizacją Cursora, zwłaszcza do głównych wersji, postępuj zgodnie z tym systematycznym podejściem:

1. Kopia zapasowa krytycznych danych

Konfiguracja

Wyeksportuj swój obecny profil, aby zachować ustawienia. Otwórz paletę poleceń (Cmd/Ctrl+Shift+P) i uruchom Preferences: Export Profile.

To zapisuje:

• Rozszerzenia i ich ustawienia
• Skróty klawiszowe
• Ustawienia użytkownika
• Fragmenty kodu
• Stan interfejsu

Reguły projektu

Utwórz kopię zapasową konfiguracji specyficznych dla projektu:

# Kopia zapasowa katalogu .cursor
cp -r .cursor .cursor.backup-$(date +%Y%m%d)

# Kopia zapasowa samych reguł
cp -r .cursor/rules .cursor/rules.backup

Historia czatu

Dla ważnych rozmów wyeksportuj je przed aktualizacją:

1. Kliknij menu „…” w czacie
2. Wybierz „Export conversation”
3. Zapisz jako markdown do przyszłego użytku

2. Sprawdź wymagania systemowe

Upewnij się, że Twój system spełnia wymagania nowej wersji:

• Miejsce na dysku: Co najmniej 2 GB wolnego (zalecane 4 GB)
• Pamięć: Minimum 8 GB RAM (16 GB dla dużych projektów)
• Kompatybilność OS: Zweryfikuj wsparcie wersji systemu w notatkach wydania

Uwaga

Mało miejsca na dysku podczas aktualizacji może spowodować utratę danych, zwłaszcza historii czatu. Zawsze utrzymuj odpowiednią ilość wolnego miejsca.

3. Przejrzyj zmiany łamiące

Sprawdź changelog pod kątem:

• Przestarzałych funkcji
• Zmian API
• Kompatybilności rozszerzeń
• Migracji konfiguracji

4. Koordynuj z zespołem

Dla środowisk zespołowych:

1. Ogłoś aktualizację — Powiadom członków zespołu o planowanej aktualizacji
2. Zaplanuj mądrze — Unikaj krytycznych terminów
3. Wdrażaj etapami — Niech jeden członek przetestuje najpierw
4. Dokumentuj problemy — Dziel się odkryciami na czacie zespołu
5. Synchronizuj czas — Aktualizujcie razem, aby utrzymać kompatybilność

Wskazówka

Nie pisz dokumentu koordynacyjnego ręcznie — wygeneruj go. Wklej to do agenta i pozwól mu napisać ogłoszenie na podstawie Twojej rzeczywistej przypiętej wersji:

“We’re upgrading Cursor from version <OLD> to <NEW> next Tuesday. Write a short Slack-ready upgrade-coordination message for the team that covers: (1) the new pinned version and where to download it, (2) a two-line ‘before you upgrade’ step (export profile, commit .cursor/ and .vscode/settings.json), (3) who the designated first tester is and the 24-hour soak window, and (4) exactly how to report a regression (link to our team channel, what to include: OS, version, the broken feature). Keep it under 150 words and skip the marketing tone.”

Wykonywanie aktualizacji

Aktualizacje automatyczne

Gdy aktualizacja jest dostępna, Cursor wyświetla pasek powiadomień. Proces aktualizacji:

1. Pojawia się powiadomienie — Baner „Update available” pokazuje się na górze
2. Kliknij „Update” lub użyj palety poleceń: Check for Updates
3. Rozpoczyna się pobieranie — Postęp pokazany na pasku stanu
4. Komunikat restartu — Kliknij „Restart to Update”, gdy będziesz gotowy
5. Uruchamia się migracja — Ustawienia i rozszerzenia migrują automatycznie

Ręczne sprawdzanie aktualizacji

Aby sprawdzić aktualizacje na żądanie, otwórz paletę poleceń (Cmd/Ctrl+Shift+P) i uruchom Check for Updates albo użyj menu: Help → Check for Updates.

Stopniowe wdrażanie

Cursor wdraża nowe wersje stopniowo, zamiast przełączać wszystkie instalacje naraz, więc wpis w changelogu może pojawić się, zanim aktualizacja dotrze do Twojej maszyny. To oczekiwane zachowanie, a nie błąd.

Notatka

Jeśli changelog pokazuje nową wersję, ale Cursor się nie aktualizuje, najprawdopodobniej po prostu nie dotarła ona jeszcze do Twojej instalacji. Sprawdź ręcznie (Help → Check for Updates), poczekaj chwilę lub przełącz się na kanał Early Access albo Nightly, aby szybciej pobierać buildy przedwydaniowe. Cursor dokumentuje dokładnie ten scenariusz w FAQ („I see an update on the changelog but Cursor won’t update”).

Weryfikacja po aktualizacji

Po aktualizacji zweryfikuj, czy wszystko działa poprawnie:

Podstawowe sprawdzenia

Rozszerzenia

• Zweryfikuj, że wszystkie rozszerzenia się załadowały
• Sprawdź ostrzeżenia kompatybilności
• Zaktualizuj przestarzałe rozszerzenia

Ustawienia

• Potwierdź, że ustawienia zostały zmigrowane
• Przetestuj niestandardowe skróty klawiszowe
• Zweryfikuj, że motyw został zastosowany poprawnie

Serwery MCP

• Przetestuj połączenia MCP
• Zweryfikuj dostępność narzędzi
• Sprawdź uprawnienia automatycznego uruchamiania

Wydajność

• Monitoruj użycie CPU/RAM
• Sprawdź status indeksowania
• Przetestuj czasy odpowiedzi

Test dymny po restarcie

Przejdź przez funkcje, na których faktycznie polegasz każdego dnia:

1. Uzupełnianie Tab — zacznij pisać w prawdziwym pliku i potwierdź, że sugestie inline nadal się pojawiają.

2. Edycja inline — zaznacz kilka linii, naciśnij Cmd/Ctrl+K i potwierdź, że panel edycji odpowiada.

3. Czat i wzmianki @ — otwórz czat, zadaj pytanie i potwierdź, że wzmianka @ przy pliku wciąga go do kontekstu.

4. Tryb agenta — daj agentowi błahe zadanie edycji i potwierdź, że potrafi czytać i zapisywać pliki.

5. Serwery MCP — otwórz czat, który korzysta z narzędzia (na przykład poproś serwer MCP do Postgresa o listę tabel) i potwierdź, że narzędzie jest wywoływalne.

6. Praca zdalna/SSH — jeśli pracujesz przez SSH, połącz się ponownie przez paletę poleceń (Remote-SSH: Connect to Host) i potwierdź, że funkcje AI działają na zdalnym hoście.

Wskazówka

Niech agent sam przeprowadzi test dymny i powie Ci, co się zepsuło. Wklej to zaraz po restarcie:

“You just got upgraded to a new Cursor version. Run a self-check and report results as a checklist: read this file and summarize it (proves chat + file context works), propose a one-line edit to it via Agent mode (proves write access), and call my Postgres MCP server to list table names (proves MCP is connected). For each step, print PASS or FAIL and, on any FAIL, the exact error text. Do not actually apply the edit — just confirm you can.”

Strategie wycofywania

Gdy aktualizacja powoduje problemy, masz kilka opcji wycofania:

Metoda 1: Przywracanie punktu kontrolnego (natychmiastowe)

System punktów kontrolnych Cursora śledzi zmiany wprowadzone przez AI:

1. Szukaj przycisku „Restore Checkpoint” przy poprzednich żądaniach
2. Kliknij, aby przywrócić ten stan
3. Uwaga: Przywraca tylko zmiany AI, nie ręczne edycje

Uwaga

Punkty kontrolne są oparte na sesji i czyszczone automatycznie. Nie zastępują kontroli wersji.

Metoda 2: Instalacja poprzedniej wersji

Aby obniżyć wersję Cursora do poprzedniej:

Windows

# 1. Odinstaluj obecną wersję
# Wyszukaj "Add or Remove Programs" → Cursor → Uninstall

# 2. Wyczyść dane aplikacji (opcjonalne, ale zalecane)
rd /s /q %USERPROFILE%\AppData\Local\Programs\cursor*
rd /s /q %USERPROFILE%\AppData\Local\Cursor*
rd /s /q %USERPROFILE%\AppData\Roaming\Cursor*

# 3. Pobierz konkretną wersję z cursor.com/changelog
# 4. Zainstaluj starszą wersję

macOS

# 1. Usuń obecną wersję
rm -rf /Applications/Cursor.app

# 2. Wyczyść dane aplikacji (opcjonalne)
rm -rf ~/Library/Application\ Support/Cursor
rm -f ~/.cursor.json

# 3. Pobierz konkretną wersję
# 4. Zainstaluj z DMG

Linux

# 1. Usuń obecny AppImage
rm ~/cursor.appimage

# 2. Wyczyść konfigurację
rm -rf ~/.cursor ~/.config/Cursor/

# 3. Pobierz poprzednią wersję
# 4. Nadaj uprawnienia do uruchamiania i odpal
chmod +x cursor-*.appimage

Metoda 3: Przywracanie profilu

Jeśli wyeksportowałeś swój profil przed aktualizacją:

1. Otwórz paletę poleceń: Ctrl/Cmd + Shift + P
2. Uruchom „Preferences: Import Profile”
3. Wybierz plik kopii zapasowej profilu
4. Wybierz, co importować (ustawienia, rozszerzenia itd.)
5. Uruchom ponownie Cursor

Metoda 4: Odzyskiwanie oparte na Git

Dla zmian w kodzie użyj kontroli wersji:

# Zobacz najnowsze commity
git log --oneline -10

# Przywróć do stanu sprzed aktualizacji
git checkout <commit-before-upgrade>

# Lub utwórz branch z tego punktu
git checkout -b pre-upgrade-backup <commit-hash>

Typowe problemy z aktualizacją

Problem: Powiadomienie o aktualizacji się nie pojawia

Objawy: Changelog pokazuje nową wersję, ale brak komunikatu o aktualizacji

Rozwiązania:

1. Sprawdź ręcznie: Help → Check for Updates
2. Etapowe wdrażanie — poczekaj 2-3 dni
3. Przełącz się na kanał Early Access
4. Sprawdź ustawienia zapory ogniowej/proxy

Problem: Rozszerzenia psują się po aktualizacji

Objawy: Rozszerzenia nie ładują się lub działają niepoprawnie

Rozwiązania:

1. Otwórz widok rozszerzeń: Ctrl/Cmd + Shift + X
2. Sprawdź aktualizacje wszystkich rozszerzeń
3. Wyłącz problematyczne rozszerzenia
4. Użyj Extension Bisect, aby zidentyfikować problemy
5. Przeinstaluj, jeśli to konieczne

Problem: Wysokie użycie zasobów po aktualizacji

Objawy: Zwiększone użycie CPU/RAM po aktualizacji

Rozwiązania (w kolejności zalecanej przez własne wskazówki Cursora dotyczące rozwiązywania problemów):

1. Sprawdź swoje rozszerzenia — uruchom ponownie z wyłączonymi rozszerzeniami, aby wyizolować winowajcę:

   cursor --disable-extensions

2. Użyj Process Explorera — otwórz paletę poleceń (Cmd/Ctrl+Shift+P) i uruchom Developer: Open Process Explorer, aby zobaczyć, który proces jest obciążony.

3. Monitoruj zasoby systemowe — na macOS ufaj zakładce Pamięć w Monitorze aktywności bardziej niż wbudowanemu ostrzeżeniu Cursora, które u niektórych użytkowników podaje skrajnie błędne wartości.

4. Przetestuj minimalną instalację — jeśli problem się utrzymuje, odtwórz go w czystym profilu, aby wykluczyć konfigurację.

Problem: Serwery MCP nie działają

Objawy: Narzędzia MCP niedostępne po aktualizacji

Rozwiązania:

1. Odśwież ustawienia MCP
2. Sprawdź kompatybilność Node.js
3. Przeinstaluj serwery MCP:

   npx -y @modelcontextprotocol/server-name

4. Zweryfikuj konfigurację w ~/.cursor/mcp.json

Problem: Utrata historii czatu

Objawy: Poprzednie rozmowy zniknęły

Zapobieganie:

• Utrzymuj odpowiednią ilość miejsca na dysku
• Eksportuj ważne czaty przed aktualizacją
• Regularne kopie zapasowe danych aplikacji

Odzyskiwanie:

• Sprawdź, czy dane istnieją w lokalizacjach kopii zapasowych
• Niestety utracona historia czatu zazwyczaj nie może być odzyskana

Najlepsze praktyki bezpiecznych aktualizacji

Dla indywidualnych deweloperów

1. Planuj aktualizacje mądrze

   • Unikaj aktualizacji przed terminami
   • Aktualizuj na początku nowego sprintu
   • Miej czas na testy i adaptację

2. Monitoruj opinie z wczesnego dostępu

   • Sprawdzaj Forum pod kątem problemów
   • Czytaj changelog uważnie
   • Poczekaj, jeśli zgłoszono krytyczne błędy

3. Prowadź kopie zapasowe

   • Regularne eksporty profili
   • Dyscyplina kontroli wersji
   • Dokumentuj niestandardowe konfiguracje

Dla zespołów

1. Ustanów protokół aktualizacji

   • Wyznaczony tester próbuje aktualizacji jako pierwszy
   • 24-godzinny okres testowania przed szerszym wdrożeniem
   • Odkrycia raportowane w kanale zespołu
   • Skoordynowana aktualizacja całego zespołu, gdy sytuacja jest jasna
   • Wszelkie problemy udokumentowane na przyszłość

2. Synchronizacja wersji

   • Trzymaj wszystkich członków zespołu na tej samej wersji
   • Udokumentuj wymaganą wersję w README
   • Dodaj do kontroli wersji .vscode/settings.json (ustawienia workspace’a), .cursor/rules/ oraz .cursor/mcp.json, aby współdzielona konfiguracja podróżowała wraz z repozytorium

3. Strategia komunikacji

   • Ogłaszaj planowane aktualizacje
   • Dziel się rozwiązaniami problemów
   • Prowadź log aktualizacji

Dla przedsiębiorstw

1. Kwestie zgodności

   • Przejrzyj poprawki bezpieczeństwa
   • Waliduj zgodnie z politykami IT
   • Testuj w środowisku sandbox

2. Wdrażanie fazowe

   • Najpierw zespół deweloperski
   • Walidacja QA
   • Wdrożenie produkcyjne

3. Wymagania dokumentacyjne

   • Rekordy zarządzania zmianą
   • Oceny wpływu
   • Procedury wycofywania

Odzyskiwanie awaryjne

Gdy wszystko inne zawiedzie, wykonaj czystą instalację:

1. Wyeksportuj obecne dane (jeśli to możliwe)

   • Ustawienia, skróty klawiszowe, fragmenty kodu
   • Listę rozszerzeń
   • Konfiguracje projektów

2. Pełna deinstalacja

   • Usuń aplikację
   • Wyczyść wszystkie dane aplikacji
   • Usuń pliki konfiguracyjne

3. Świeża instalacja

   • Pobierz najnowszą stabilną wersję
   • Zainstaluj z domyślnymi ustawieniami
   • Stopniowo przywracaj dostosowania

4. Przyrostowe przywracanie

   • Najpierw importuj ustawienia
   • Dodawaj rozszerzenia po jednym
   • Przywracaj konfiguracje projektów

Kolejne kroki

Historia wersji Poznaj kompletny changelog i ewolucję funkcji

Adopcja funkcji Naucz się skutecznie adoptować nowe funkcje w miarę ich wydawania

Przewodnik rozwiązywania problemów Kompleksowe rozwiązania typowych problemów z Cursorem