Przejdź do treści
100% lokalnie

generator devcontainer.json

Wygeneruj gotowy devcontainer.json dla VS Code z obsługą Node.js, Python, Go, PHP, Java lub Ubuntu z opcjonalnym Dockerfile.

Wynik

generator devcontainer.json

Wybierz język i to narzędzie wygeneruje gotowy plik devcontainer.json dla rozszerzenia VS Code Dev Containers (i dla GitHub Codespaces, który czyta ten sam plik). Wybierz Node.js, Python, Go, PHP, Java lub zwykły obraz Ubuntu, ustaw wersję i generator uzupełni odpowiadający obraz Microsoft devcontainers, rozsądne domyślne ustawienia kontenera i domyślny port do przodu.

Opcje mapują się bezpośrednio na pola, których potrzebuje rzeczywisty devcontainer.json. Włącz funkcje Git i Docker-in-Docker albo dodaj Node.js do kontenera bez Node i trafią do obiektu "features" z prawidłową referencją ghcr.io. Wylistuj porty do przodu, postCreateCommand i postStartCommand, aby uruchomić kroki konfiguracji automatycznie po uruchomieniu kontenera. Rozszerzenia VS Code i ustawienia idą w "customizations.vscode", jeden identyfikator rozszerzenia lub jedno ustawienie klucz=wartość na linię. Włączenie "Zamontuj tom pamięci podręcznej" dodaje nazwany wolumin dla pamięci podręcznej zależności tego języka — node_modules, pamięć podręczna pip, moduł Go — aby odbudowa nie rozpoczynała się od zera. Włączenie "Wygeneruj też Dockerfile" zamienia pole "image" na referencję "build" i tworzy do niej odpowiadający Dockerfile.

Nieprawidłowe wpisy są pomijane zamiast łamać plik: błędny port, identyfikator rozszerzenia bez formatu publisher.name albo linia ustawienia bez "=" jest po prostu pominięta i pole wersji usuwa wszystko, co nie jest literą, cyfrą, kropką lub myślnikiem, zanim dotrze do tagu obrazu. Wynik jest zawsze prawidłowy, parsownalny JSON i licznik poniżej wykreślenia pokazuje ile plików, funkcji i znaków zostało wygenerowane podczas dostosowywania opcji.

Wszystko działa lokalnie w Twojej przeglądarce — szczegóły projektu, lista rozszerzeń czy konfiguracja środowiska nigdy nie opuszczą Twojej maszyny. Skopiuj wynik, pobierz go jako plik .txt do wklejenia w .devcontainer/devcontainer.json (i Dockerfile, jeśli go wygenerowałeś) lub wyślij go do wejścia innego narzędzia, aby kontynuować pracę.

Częste pytania

Gdzie w moim projekcie umieścić ten plik?
Zapisz go jako .devcontainer/devcontainer.json. Jeśli wygenerowałeś też Dockerfile, zapisz go jako .devcontainer/Dockerfile w tym sam folderze.
Co to są "funkcje" w devcontainer.json?
Funkcje to małe, wielokrotnie użyteczne elementy konfiguracji — instalacja Git, włączenie Docker-in-Docker, dodanie runtime języka — które są dodawane do obrazu bazowego bez konieczności pisania Dockerfile.
Co się stanie, jeśli zostawię pole wersji puste?
Generator używa aktualnego domyślnego tagu obrazu dla tego języka, więc plik jest zawsze prawidłowy bez konieczności szukania jednego.
Dlaczego mój identyfikator rozszerzenia lub port zniknął z wyjścia?
Wpis, który nie pasuje do oczekiwanego kształtu — identyfikator rozszerzenia bez formatu publisher.name lub port poza 1–65535 — jest pomijany, aby wygenerowany plik pozostał zawsze prawidłowy.
Czy moja konfiguracja projektu jest gdzieś przesyłana?
Nie. Plik devcontainer.json (i Dockerfile) jest generowany całkowicie w Twojej przeglądarce na podstawie wybranych opcji — nic nie jest wysyłane na serwer.