Ubuntu install Visual Studio Code — przewodnik 2026
VS Code na Ubuntu instalowany jest trzema ścieżkami — przez oficjalne repozytorium APT Microsoftu (zalecane), przez Snap (sudo snap install code --classic) lub przez pobranie pakietu .deb ze strony code.visualstudio.com. Najszybsza i najbardziej stabilna metoda to repozytorium APT, które zapewnia automatyczne aktualizacje, integrację z menedżerem pakietów systemu oraz pełną zgodność z bibliotekami Ubuntu 24.04 LTS i nowszymi wydaniami. Poniższy przewodnik szczegółowo opisuje każdą z metod instalacji, konfigurację środowiska programistycznego, rozwiązywanie typowych problemów oraz optymalizację VS Code pod kątem technologii webowych, Python, C++ i kontenerów. Artykuł uwzględnia stan ekosystemu na połowę 2026 roku — Ubuntu 24.04 LTS i 26.04, VS Code 1.98+, Node.js 24 LTS, Python 3.13, .NET 10 Preview.
Wymagania wstępne — co musisz mieć przed instalacją
Przed rozpoczęciem instalacji Visual Studio Code na Ubuntu zweryfikuj wersję systemu oraz dostępne zasoby. VS Code działa poprawnie na każdym wydaniu Ubuntu od 22.04 LTS wzwyż, ale Microsoft rekomenduje Ubuntu 24.04 LTS jako minimalną bazę dla pełnego wsparcia wszystkich rozszerzeń — szczególnie tych korzystających z natywnych modułów Node.js, które wymagają glibc 2.35+. Poniższa tabela podsumowuje wymagania.
| Komponent | Minimum | Zalecane |
|---|---|---|
| System operacyjny | Ubuntu 22.04 LTS (64-bit) | Ubuntu 24.04 LTS / 26.04 (64-bit) |
| Architektura | x86_64 | x86_64 (ARM64 przez Snap) |
| RAM | 2 GB | 8 GB (projekty Node.js/Python) |
| Miejsce na dysku | 500 MB | 2 GB (z rozszerzeniami i cache) |
| glibc | 2.28 | 2.35 lub nowsza |
| Menedżer okien | X11 lub Wayland | Wayland (natywne wsparcie od VS Code 1.96) |
| Uprawnienia | sudo (konto administratorskie) | sudo z aktualnym apt update |
Dodatkowo upewnij się, że system ma zainstalowane podstawowe narzędzia: curl, gnupg oraz software-properties-common. Jeśli ich nie ma, zainstaluj jednym poleceniem:
sudo apt update && sudo apt install -y curl gnupg software-properties-common
Brak tych pakietów to najczęstsza przyczyna niepowodzeń podczas dodawania zewnętrznych repozytoriów. Po ich zainstalowaniu możesz przejść do właściwej instalacji.
Instalacja przez oficjalne repozytorium APT — metoda zalecana
Instalacja przez repozytorium APT to jedyna metoda, która zapewnia pełną integrację z ekosystemem Ubuntu — aktualizacje przychodzą razem z apt upgrade, podpis cyfrowy paczek jest weryfikowany automatycznie, a zależności są rozwiązywane przez APT. Microsoft udostępnia własne repozytorium packages.microsoft.com, które w 2026 roku zawiera VS Code 1.98 z gałęzi stable oraz opcjonalnie insider builds.
Wykonaj kolejno poniższe kroki.
1. Import klucza GPG Microsoftu. Klucz weryfikuje autentyczność pakietów pobieranych z repozytorium. Microsoft rotuje klucze co 2 lata — aktualny klucz dla 2026 roku pobierzesz poleceniem:
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg
2. Dodanie repozytorium. Plik .list w katalogu /etc/apt/sources.list.d/ informuje APT o nowym źródle pakietów. Użyj architektury amd64 dla procesorów Intel/AMD:
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code stable main" | sudo tee /etc/apt/sources.list.d/vscode.list
3. Aktualizacja list pakietów i instalacja. Po dodaniu repozytorium odśwież indeks APT i zainstaluj VS Code:
sudo apt update && sudo apt install -y code
Po zakończeniu instalacji VS Code pojawi się w menu aplikacji jako "Visual Studio Code" i będzie dostępny z terminala jako code. Wpisz code --version, aby potwierdzić instalację — powinieneś zobaczyć numer wersji oraz commit hash.
4. Opcjonalnie: instalacja wersji Insider. Jeśli potrzebujesz najnowszych funkcji (np. AI Agent Mode, Copilot 2.0, rozszerzone wsparcie dla języków), dodaj repozytorium insider:
echo "deb [arch=amd64 signed-by=/usr/share/keyrings/microsoft.gpg] https://packages.microsoft.com/repos/code insider main" | sudo tee /etc/apt/sources.list.d/vscode-insiders.list
sudo apt update && sudo apt install -y code-insiders
Wersja Insider jest aktualizowana codziennie. Może zawierać błędy, ale daje dostęp do funkcji testowanych przed wydaniem stabilnym. Obie wersje można zainstalować równolegle — nie kolidują ze sobą.
Instalacja przez Snap — prostota i izolacja
Snap to format pakietów opracowany przez Canonical, domyślnie obecny w Ubuntu. VS Code w Snap Store jest utrzymywany bezpośrednio przez Microsoft i aktualizowany automatycznie w tle. Metoda snap jest najprostsza, ale ma ograniczenia — aplikacja działa w izolowanym środowisku (sandbox), co może powodować problemy z dostępem do niektórych katalogów, terminali systemowych czy rozszerzeń wymagających natywnego dostępu.
Instalacja przez Snap sprowadza się do jednego polecenia:
sudo snap install code --classic
Flaga --classic jest kluczowa — nadaje aplikacji uprawnienia wykraczające poza sandbox, umożliwiając dostęp do całego systemu plików i uruchamianie kompilatorów, debuggerów oraz narzędzi CLI bezpośrednio z terminala VS Code. Bez flagi --classic wiele rozszerzeń (np. Python Debugger, C/C++ IntelliSense, platformio) nie będzie działać poprawnie.
Snap automatycznie aktualizuje VS Code do najnowszej wersji stabilnej, zazwyczaj w ciągu 24 godzin od wydania przez Microsoft. Aktualizacje są wymuszane — nie możesz ich zatrzymać ani opóźnić, co bywa problematyczne w środowiskach produkcyjnych. Jeśli potrzebujesz kontroli nad wersją, wybierz APT lub .deb.
Dodatkowa zaleta Snapa: VS Code przez Snap działa natywnie na architekturze ARM64 (np. Raspberry Pi 5, laptopy Snapdragon X Elite). Instalacja jest identyczna, a Snap automatycznie pobiera odpowiedni build.
Instalacja przez pakiet .deb — pełna kontrola offline
Pobranie pakietu .deb ze strony code.visualstudio.com daje pełną kontrolę nad wersją i umożliwia instalację offline — przydatne na serwerach bez dostępu do internetu lub w środowiskach z restrykcyjnymi politykami bezpieczeństwa. Proces przebiega następująco:
1. Pobierz pakiet. Otwórz https://code.visualstudio.com/Download w przeglądarce i wybierz wersję .deb (64-bit) lub użyj wget:
wget -O code.deb "https://code.visualstudio.com/sha/download?build=stable&os=linux-deb-x64"
2. Zainstaluj przez APT (nie dpkg). Użyj apt install, ponieważ automatycznie rozwiąże zależności, podczas gdy dpkg -i pozostawi niezainstalowane zależności w stanie broken:
sudo apt install -y ./code.deb
3. Zweryfikuj instalację. Uruchom code --version.
Wadą tej metody jest brak automatycznych aktualizacji — musisz ręcznie pobierać i instalować każdą nową wersję. Rozwiązaniem pośrednim jest skrypt cron, który raz w tygodniu sprawdza najnowszą wersję i aktualizuje pakiet, ale to wymaga dodatkowej automatyzacji.
Metoda .deb sprawdza się również, gdy potrzebujesz konkretnej, starszej wersji VS Code — archiwum dostępne jest w repozytorium GitHub Microsoftu (github.com/microsoft/vscode/releases).
Porównanie metod instalacji — tabela decyzyjna
Każda metoda instalacji VS Code na Ubuntu ma swoje mocne i słabe strony. Poniższa tabela pomoże Ci wybrać optymalną ścieżkę.
| Kryterium | APT (repozytorium) | Snap | .deb (ręcznie) |
|---|---|---|---|
| Automatyczne aktualizacje | Tak (apt upgrade) | Tak (wymuszone, tło) | Nie (ręcznie) |
| Integracja z systemem | Pełna | Ograniczona (sandbox) | Pełna |
| Zależności | Automatyczne | W pakiecie Snap | Automatyczne przy apt install |
| Wsparcie ARM64 | Nie (tylko x86_64) | Tak | Nie (tylko x86_64) |
| Kontrola wersji | Częściowa (apt hold) | Brak | Pełna |
| Instalacja offline | Nie | Nie | Tak |
| Szybkość uruchamiania | Natywna | Wolniejszy pierwszy start | Natywna |
| Bezpieczeństwo | Klucz GPG, podpisane pakiety | Sandbox Snap | Brak weryfikacji automatycznej |
| Zalecany scenariusz | Codzienna praca deweloperska | ARM64, prostota | Offline, konkretna wersja |
Dla 90% użytkowników Ubuntu w 2026 roku repozytorium APT jest optymalnym wyborem — łączy wygodę automatycznych aktualizacji z pełną integracją systemową. Snap wybierz tylko na ARM64 lub gdy absolutnie nie chcesz zarządzać repozytoriami. .deb to narzędzie specjalistyczne — dla administratorów i środowisk air-gapped.
Konfiguracja VS Code po instalacji — pierwsze kroki
Po zainstalowaniu VS Code warto poświęcić 15 minut na konfigurację, która radykalnie zwiększy komfort pracy. Poniższa lista zawiera elementy, które mają największy wpływ na produktywność w 2026 roku.
Synchronizacja ustawień przez konto Microsoft. Kliknij ikonę konta w lewym dolnym rogu → "Włącz synchronizację ustawień". VS Code synchronizuje rozszerzenia, skróty klawiszowe, fragmenty kodu (snippets) i ustawienia UI między wszystkimi urządzeniami. W 2026 roku synchronizacja obejmuje również profile — możesz przełączać się między konfiguracją dla Pythona, frontendu i DevOps jednym kliknięciem.
Instalacja niezbędnych rozszerzeń. Otwórz panel rozszerzeń (Ctrl+Shift+X). Minimum dla każdego dewelopera w 2026 roku:
- GitHub Copilot — asystent AI z trybem Agent Mode (autonomiczne pisanie kodu, refaktoryzacja, generowanie testów). Copilot 2.0 w 2026 roku obsługuje kontekst całego repozytorium i potrafi edytować wiele plików jednocześnie.
- GitLens — zaawansowana integracja z Gitem: historia linii, blame, porównywanie gałęzi.
- Prettier — formatowanie kodu dla JS/TS, HTML, CSS, JSON, Markdown.
- ESLint — linting JavaScript i TypeScript z automatycznymi poprawkami.
- Python (Microsoft) — pełne wsparcie dla Pythona 3.13: IntelliSense, debugging, testy.
- Error Lens — wyświetla błędy i ostrzeżenia bezpośrednio w kodzie obok linii.
Konfiguracja terminala. VS Code używa domyślnej powłoki Ubuntu. Otwórz terminal (`Ctrl+``) i ustaw preferowaną powłokę przez menu rozwijane po prawej stronie panelu terminala. Dla Ubuntu 24.04+ domyślną powłoką jest bash, ale możesz przełączyć na zsh, fish lub PowerShell. Terminal VS Code obsługuje wszystkie funkcje terminala systemowego, w tym kolory, Unicode i skróty klawiszowe.
Konfiguracja fontu. Zainstaluj JetBrains Mono — darmowy font z ligaturami programistycznymi, który stał się standardem w 2026 roku:
sudo apt install -y fonts-jetbrains-mono
Następnie w ustawieniach VS Code (Ctrl+,), wyszukaj font family i ustaw 'JetBrains Mono', monospace. Włącz ligatury opcją editor.fontLigatures: true.
Profil dla Ubuntu. VS Code 1.96+ oferuje wbudowany profil "Linux Development", który preinstaluje rozszerzenia dla Dockera, Kubernetes, Pythona, Node.js i Basha. Aktywuj go przez menu: ikona koła zębatego → "Profile" → "Import Profile" → wybierz "Linux Development".
Rozwiązywanie problemów z instalacją
Podczas instalacji VS Code na Ubuntu mogą wystąpić problemy — od błędów GPG, przez konflikty zależności, po brak możliwości uruchomienia. Poniżej znajdują się najczęstsze przypadki wraz z konkretnymi rozwiązaniami.
Błąd GPG: NO_PUBKEY. APT odrzuca repozytorium, ponieważ klucz nie został zaimportowany lub jest nieaktualny. Rozwiązanie: pobierz aktualny klucz i zaimportuj ponownie:
curl -fsSL https://packages.microsoft.com/keys/microsoft.asc | sudo gpg --dearmor -o /usr/share/keyrings/microsoft.gpg --yes
sudo apt update
Zależności nie do spełnienia. Jeśli apt install code zgłasza niespełnione zależności (np. libgtk-3-0, libnss3), zainstaluj je ręcznie:
sudo apt install -f
Jeśli to nie pomoże, sprawdź brakujące pakiety przez apt-cache depends code i zainstaluj każdy z osobna.
VS Code nie uruchamia się. Najczęściej problem leży w GPU lub Waylandzie. Uruchom z flagami debugowania:
code --disable-gpu --verbose
Jeśli to pomoże, problem leży w akceleracji sprzętowej. Dodaj flagę --disable-gpu na stałe w pliku .desktop (w katalogu /usr/share/applications/code.desktop) lub w aliasie shella.
Konflikt z Waylandem. Na Ubuntu 24.04+ z Waylandem VS Code może migotać lub nie renderować okna. Rozwiązanie: uruchom z flagą --enable-features=UseOzonePlatform --ozone-platform=wayland lub przełącz się na X11 w ekranie logowania.
Snap: błąd uprawnień. Jeśli VS Code przez Snap nie widzi katalogu domowego lub nie może uruchomić kompilatora, sprawdź, czy zainstalowałeś z flagą --classic. Bez niej usuń i zainstaluj ponownie:
sudo snap remove code && sudo snap install code --classic
Konflikt instalacji APT i Snap. Posiadanie obu wersji powoduje konflikt — polecenie code w terminalu może uruchamiać nie tę wersję, której oczekujesz. Zdecyduj się na jedną metodę i odinstaluj drugą:
# Usuń wersję Snap
sudo snap remove code
# LUB usuń wersję APT
sudo apt remove --purge code
Visual Studio Code na Ubuntu — scenariusze użycia
VS Code łączy w sobie lekkość edytora tekstu z funkcjonalnością IDE. Na Ubuntu w 2026 roku obsługuje praktycznie każdy stos technologiczny. Poniżej znajdują się scenariusze pokazujące, jak skonfigurować VS Code dla konkretnych technologii.
Full-stack web development (React + Node.js + PostgreSQL). Zainstaluj rozszerzenia: ES7+ React/Redux/React-Native snippets, JavaScript (ES6) code snippets, Thunder Client (zamiennik Postmana w VS Code), Prisma (dla ORM). Skonfiguruj launch.json dla debugowania Node.js 24 LTS z opcją --watch (nowy flag Node.js od wersji 24). VS Code automatycznie wykryje aplikację Next.js, Remix lub Astro i zasugeruje odpowiedni debugger.
Python 3.13 + Jupyter Notebooks. Rozszerzenie Python od Microsoftu w 2026 roku oferuje natywne wsparcie dla Jupytera — notebooki .ipynb otwierają się bezpośrednio w edytorze z dostępem do zmiennych, wykresów i interaktywnych widgetów. Zainstaluj również rozszerzenia Python Debugger, Pylance i Black Formatter. Dla data science dobierz Jupyter, Jupyter Keymap i Jupyter Slide Show.
C/C++ z CMake i GCC 14. Ubuntu 24.04 LTS dostarcza GCC 14. Rozszerzenie C/C++ od Microsoftu zapewnia IntelliSense, debugging i nawigację. Dla projektów CMake zainstaluj CMake Tools — daje automatyczną konfigurację, budowanie i testowanie z poziomu paska bocznego. Dla embedded development dodaj PlatformIO IDE (platforma do Arduino, ESP32, STM32).
Kontenery Docker i Kubernetes. VS Code posiada rozszerzenie Dev Containers, które pozwala na rozwój wewnątrz kontenera Docker. Całe środowisko deweloperskie — kompilatory, biblioteki, narzędzia CLI — jest definiowane w pliku devcontainer.json i automatycznie uruchamiane przez VS Code. W połączeniu z Kubernetes rozszerzeniem możesz zarządzać klastrami K8s bezpośrednio z edytora. Dla orkiestracji wielu kontenerów użyj Docker Compose — VS Code obsługuje profile Compose od wersji 1.94.
Praca zdalna przez SSH. Rozszerzenie Remote — SSH umożliwia edycję plików na zdalnym serwerze tak, jakby były lokalne. VS Code instaluje lekki serwer na zdalnej maszynie, a całe przetwarzanie — IntelliSense, debugging, terminal — odbywa się zdalnie. W 2026 roku rozszerzenie wspiera uwierzytelnianie przez klucze ED25519 oraz agenta SSH, co eliminuje potrzebę ręcznego wpisywania haseł.
Częste pytania
Jak odinstalować Visual Studio Code z Ubuntu?
Jeśli instalowałeś przez APT: sudo apt remove --purge code && sudo rm /etc/apt/sources.list.d/vscode.list && sudo apt update. Jeśli przez Snap: sudo snap remove code. Jeśli przez .deb: sudo apt remove --purge code. Po odinstalowaniu usuń katalog konfiguracyjny ~/.config/Code i ~/.vscode, aby wyczyścić wszystkie dane użytkownika.
Czy VS Code na Ubuntu obsługuje GitHub Copilot?
Tak, GitHub Copilot 2.0 działa w pełni na Ubuntu — zarówno w wersji APT, Snap, jak i .deb. Wymaga zalogowania się kontem GitHub i aktywnej subskrypcji Copilot (lub darmowego planu dla studentów i open-source maintainerów). Agent Mode, dostępny od VS Code 1.98, umożliwia autonomiczną edycję wielu plików, generowanie commit message i tworzenie pull requestów bez opuszczania edytora.
Czy mogę uruchomić VS Code na Ubuntu Server (bez GUI)?
Nie bezpośrednio — VS Code wymaga środowiska graficznego. Ale możesz użyć code-server (projekt open-source od Coder), który udostępnia VS Code jako aplikację webową dostępną przez przeglądarkę na porcie 8080. Instalacja: curl -fsSL https://code-server.dev/install.sh | sh. Alternatywnie, użyj code serve-web wbudowanego w VS Code od wersji 1.92: uruchom code serve-web --without-connection-token na maszynie z GUI i połącz się przez przeglądarkę.
Którą wersję VS Code wybrać — stable czy insider?
Stable dla codziennej pracy produkcyjnej, gdzie stabilność jest priorytetem. Insider dla deweloperów, którzy chcą testować najnowsze funkcje (Copilot Agent Mode, nowe protokoły LSP, wsparcie dla eksperymentalnych języków). Insider otrzymuje aktualizacje codziennie, stable — co miesiąc. Obie wersje mogą być zainstalowane równolegle.
Dlaczego VS Code po aktualizacji Ubuntu nie działa?
Aktualizacja systemu mogła nadpisać biblioteki współdzielone (np. libffmpeg.so, libGLESv2.so), których VS Code używa do renderowania i odtwarzania mediów. Rozwiązanie: uruchom code --disable-gpu i jeśli zadziała, zaktualizuj sterowniki graficzne przez sudo ubuntu-drivers autoinstall. W ostateczności przeinstaluj VS Code — polecenie sudo apt install --reinstall code przywróci fabryczne zależności.
Jak zainstalować VS Code na Ubuntu w wersji ARM64 (Raspberry Pi)?
Użyj Snapa: sudo snap install code --classic. Snap automatycznie wykrywa architekturę ARM64 i pobiera odpowiedni build. Alternatywnie, skorzystaj z community buildów dostępnych w repozytorium ppa:ubuntu-raspberrypi/ppa, ale Snap jest oficjalnie wspierany przez Microsoft i otrzymuje aktualizacje jako pierwszy.
Czy VS Code na Ubuntu wspiera .NET 10 i C# 14?
Tak — przez rozszerzenie C# Dev Kit od Microsoftu, które działa na Ubuntu z .NET SDK 10. Zainstaluj .NET SDK: sudo apt install dotnet-sdk-10.0 (z repozytorium Microsoftu). Następnie w VS Code zainstaluj C# Dev Kit — otrzymasz pełne IntelliSense, debugging, zarządzanie projektami i testami oraz wsparcie dla Blazor, ASP.NET Core i MAUI (przez remote build).
Gdzie VS Code przechowuje ustawienia i rozszerzenia?
Ustawienia użytkownika: ~/.config/Code/User/settings.json. Rozszerzenia: ~/.vscode/extensions/. Cache i dane runtime: ~/.config/Code/Cache/ i ~/.config/Code/CachedData/. Globalne snippety: ~/.config/Code/User/snippets/. Aby całkowicie wyczyścić VS Code i zacząć od zera, usuń katalogi ~/.config/Code i ~/.vscode — po ponownym uruchomieniu aplikacja utworzy je od nowa z wartościami domyślnymi.
Jakie są ograniczenia wersji Snap w porównaniu do APT?
Wersja Snap działa w izolowanym środowisku i domyślnie ma ograniczony dostęp do zasobów systemowych — nie widzi ukrytych katalogów (.), nie może uruchamiać niektórych narzędzi CLI spoza sandboxa oraz ma problemy z integracją z menedżerami pakietów językowych (pip, npm, cargo), gdy te próbują instalować globalnie. Flaga --classic rozwiązuje większość z tych problemów, ale nie wszystkie. Jeśli intensywnie korzystasz z kontenerów Docker lub debuggerów niskopoziomowych, wybierz APT.
Czy mogę zsynchronizować VS Code między Ubuntu a Windows/macOS?
Tak, przez wbudowaną funkcję Settings Sync (konto Microsoft lub GitHub). Synchronizowane są: rozszerzenia, ustawienia UI i JSON, skróty klawiszowe, snippety, profile oraz stan interfejsu (układ paneli). Synchronizacja nie obejmuje plików konfiguracyjnych projektu (.vscode/ w repozytorium) — te są udostępniane przez Git. W 2026 roku Settings Sync obsługuje również historię zmian, więc możesz cofnąć synchronizację do poprzedniego stanu.
Jeśli szukasz stabilnego dostępu do narzędzi Microsoft na swoim Ubuntu, sprawdź legalne klucze Microsoft 365 w KluczeSoft.pl — Faktura VAT 23%, dostawa w 1–3 minuty, pełna zgodność z KSeF.
Sprawdź też
- Ubuntu Visual Studio Code — kompletny przewodnik 2026
- Python in Visual Studio Code — przewodnik 2026
- Linux visual studio code — przewodnik 2026
- Code Visual Studio Code — przewodnik 2026
Potrzebujesz licencji? Microsoft Office — sprawdź ofertę KluczeSoft.pl — legalne klucze, faktura VAT, dostawa e-mail.
