Freigeben über

Einrichten von Dev-Containern auf Windows

Mit einem Dev-Container können Sie einen Docker-Container als vollständige Entwicklungsumgebung verwenden, die durch eine devcontainer.json in Ihr Repository eingecheckte Datei definiert wird. Jeder, der das Projekt öffnet, erhält dieselben Tools, Erweiterungen und Einstellungen – unabhängig davon, was auf seinem lokalen Computer installiert ist.

Auf dieser Seite werden die Windows-spezifischen Setups behandelt. Eine vollständige Einführung in die Funktionsweise von Dev-Containern finden Sie in der Dev Containers-Dokumentation auf der VS Code-Website.

Voraussetzungen

Dev Containers on Windows erfordert Folgendes:

  • WSL 2 – Windows-Subsystem für Linux, Version 2. Installieren Sie WSL , falls noch nicht geschehen.
  • Docker Desktop für Windows mit aktivierter WSL 2-Back-End-Funktion. Laden Sie Docker Desktop herunter , und folgen Sie dem Installationsprogramm. Stellen Sie während des Setups sicher, dass "WSL 2-basiertes Modul verwenden" in den Docker-Desktopeinstellungen (Allgemeine Einstellungen>) ausgewählt ist.
  • Visual Studio Code – Download VS Code.
  • Dev Containers-Erweiterung – Installieren Sie die Dev Containers-Erweiterung aus dem VS Code Marketplace.

Wo Ihre Dateien gespeichert werden, ist wichtig

Von Bedeutung

Bei Windows hängt die Leistung des Dev-Containers stark davon ab, wo Sich Ihre Projektdateien befinden. Speichern Sie Ihr Projekt im Dateisystem WSL 2 (z. B. /home/yourname/projects/), nicht im Windows Dateisystem (z. B. C:\Users\yourname\projects\).

Wenn sich Ihre Dateien im Windows Dateisystem (C:\) befinden, greift Docker über eine osübergreifende Dateifreigabe auf sie zu, was deutlich langsamer ist. Wenn sich Ihre Dateien im WSL 2-Dateisystem befinden, verwendet Docker systemeigene Linux-E/A, wodurch die Leistung erheblich besser ist – insbesondere bei Builds und Tools zur Dateiüberwachung.

Um in das WSL 2-Dateisystem zu klonen, öffnen Sie Ihre WSL-Distribution (z. B. Ubuntu) über das Startmenü oder Windows-Terminal und führen Sie dort den Klonvorgang durch.

cd ~
mkdir projects && cd projects
git clone https://github.com/your-org/your-repo.git

Öffnen Sie dann diesen Ordner in VS Code aus WSL:

code your-repo

VS Code stellt eine Verbindung mit WSL her und erkennt devcontainer.json, wenn einer vorhanden ist.

Öffnen eines Projekts in einem Dev-Container

Sobald Ihr Projekt in VS Code geöffnet ist (mit WSL verbunden):

  1. Drücken Sie F1 und wählen Sie Dev Container: Erneut im Container öffnen.
  2. VS Code erstellt das Container-Image, das in .devcontainer/devcontainer.json definiert ist, oder fordert Sie auf, eines hinzuzufügen, wenn keines vorhanden ist.
  3. Wenn der Build abgeschlossen ist, stellt VS Code die Verbindung innerhalb des Containers mit allen konfigurierten Tools und Erweiterungen wieder her.

Um zu Ihrer lokalen Umgebung zurückzukehren, drücken Sie F1 , und wählen Sie "Dev Containers" aus: Ordner lokal erneut öffnen.

Hinzufügen eines Dev-Containers zu einem vorhandenen Projekt

Wenn Ihr Projekt noch kein devcontainer.json hat:

  1. Drücken Sie F1 und wählen Sie Entwicklungscontainer: Entwicklungscontainer-Konfigurationsdateien hinzufügen aus.
  2. Wählen Sie ein Basisimage aus (z. B. Node.js, Python oder ein generisches Debian/Ubuntu-Image).
  3. VS Code erstellt eine .devcontainer/devcontainer.json Datei, die Sie in die Quellcodeverwaltung einchecken können.

Die vollständige Referenz der devcontainer.json Optionen finden Sie in der devcontainer.json Referenz auf der Dev Container Specification-Website.

Problembehandlung

Container wird gestartet, Dateiänderungen werden jedoch nicht erkannt Ihr Projekt wird wahrscheinlich im Windows Dateisystem gespeichert. Verschieben Sie sie in WSL (siehe "Wo Sie Ihre Dateien speichern" oben ).

Docker Desktop startet nicht, oder die WSL-Integration fehlt. Öffnen Sie Docker Desktop, wechseln Sie zurWSL-Integration der >>, und aktivieren Sie die Integration für Ihre installierten WSL-Verteilungen.

VS Code kann keine Verbindung mit dem Container herstellen Stellen Sie sicher, dass Docker Desktop ausgeführt wird, bevor Sie VS Code öffnen. Überprüfen Sie das Docker Desktop-Taskleistensymbol.

Nächste Schritte

  • Last updated on