Einrichten einer WSL-Entwicklungsumgebung

Eine Schritt-für-Schritt-Anleitung zu den bewährten Methoden zum Einrichten einer WSL-Entwicklungsumgebung. Erfahren Sie, wie Sie den Befehl ausführen, um die Bash-Standardshell zu installieren, die Ubuntu verwendet oder für die Installation anderer Linux-Distributionen festgelegt werden kann, wie Sie grundlegende WSL-Befehle verwenden, Visual Studio Code oder Visual Studio, Git, Windows-Anmeldeinformationsverwaltung, Datenbanken wie MongoDB, Postgres oder MySQL einrichten, GPU-Beschleunigung einrichten, GUI-Apps ausführen und vieles mehr.

Erste Schritte

Das Windows-Subsystem für Linux ist mit dem Windows-Betriebssystem ausgestattet, aber Sie müssen es aktivieren und eine Linux-Distribution installieren, bevor Sie es verwenden können.

Öffnen Sie PowerShell (oder die Windows-Eingabeaufforderung), und geben Sie Folgendes ein:

Hinweis

Der Befehl wsl --install erfordert Windows 10 Version 2004 (Build 19041) oder höher oder Windows 11. Wenn Sie lieber eine andere Linux-Verteilung installieren oder diese Schritte manuell ausführen möchten, finden Sie weitere Details auf der WSL-Installationsseite .

wsl --install

Der --install Befehl führt die folgenden Aktionen aus:

  • Aktiviert die optionalen Komponenten WSL und Plattform für virtuelle Maschinen.
  • Der aktuelle Linux-Kernel wird heruntergeladen und installiert.
  • WSL 2 wird als Standard festgelegt.
  • Eine Ubuntu Linux-Distribution wird heruntergeladen und installiert (möglicherweise ist ein Neustart erforderlich)

Sie werden Ihren Computer während dieses Installationsvorgangs neu starten müssen.

PowerShell-Befehlszeile mit ausgeführtem Befehl „wsl --install“

Lesen Sie den Artikel zur Fehlerbehebung bei der Installation, wenn Sie auf Probleme stoßen.

Einrichten des Linux-Benutzernamens und -Kennworts

Sobald der Installationsprozess Ihrer Linux-Distribution mit WSL abgeschlossen ist, öffnen Sie die Distribution (standardmäßig Ubuntu) über das Startmenü. Sie werden aufgefordert, einen Benutzernamen und ein Kennwort für Ihre Linux-Distribution zu erstellen.

  • Diese Kombination aus Benutzername und Kennwort ist spezifisch für jede einzelne Linux-Verteilung, die Sie installieren, und hat keinen Einfluss auf Ihren Windows-Benutzernamen.

  • Bitte beachten Sie, dass Sie beim Eingeben des Kennworts auf dem Bildschirm nichts sehen werden. Dies wird als blinde Eingabe bezeichnet. Sie werden nicht sehen, was Sie eingeben, dies ist völlig normal.

  • Nachdem Sie einen Benutzernamen und das Kennwort erstellt haben, ist das Konto Ihr Standardbenutzer für die Verteilung und wird beim Start automatisch angemeldet.

  • Dieses Konto gilt als Linux-Administrator und kann sudo-Administratorbefehle (Super User Do) ausführen.

  • Jede Linux-Distribution, die unter WSL ausgeführt wird, verfügt über eigene Linux-Benutzerkonten und -Kennwörter. Jedes Mal, wenn Sie eine Distribution hinzufügen, neu installieren oder zurücksetzen, müssen Sie ein Linux-Benutzerkonto konfigurieren.

Hinweis

Mithilfe von WSL installierte Linux-Distributionen sind benutzerspezifische Installationen und können nicht für andere Windows-Benutzerkonten freigegeben werden. Tritt ein Fehler beim Benutzernamen auf? StackExchange: Welche Zeichen sollte ich in Benutzernamen unter Linux verwenden bzw. vermeiden?

Ubuntu-Befehlszeile: UNIX-Benutzernamen eingeben

Um Ihr Passwort zu ändern oder zurückzusetzen, öffnen Sie die Linux-Distribution und geben Sie den Befehl ein: passwd. Sie werden aufgefordert, Ihr aktuelles Kennwort und Ihr neues Kennwort einzugeben und anschließend Ihr neues Kennwort zu bestätigen.

Wenn Sie das Kennwort für Ihre Linux-Verteilung vergessen haben:

  1. Öffnen Sie PowerShell, und wechseln Sie mit dem folgenden Befehl in das Stammverzeichnis Ihrer Standard-WSL-Distribution: wsl -u root

    Wenn Sie das vergessene Kennwort für eine Verteilung aktualisieren müssen, die nicht Ihre Standardverteilung ist, verwenden Sie den Befehl: wsl -d <DistroName> -u root, wobei Sie <DistroName> durch den Namen Ihrer Zielverteilung ersetzen.

  2. Sobald Ihre WSL-Distribution in PowerShell mit Root-Rechten geöffnet wurde, können Sie diesen Befehl verwenden, um Ihr Kennwort zurückzusetzen: passwd <username>, wobei <username> der Benutzername des Kontos in der Distribution ist, dessen Kennwort Sie vergessen haben.

  3. Sie werden aufgefordert, ein neues UNIX-Kennwort einzugeben und dieses Kennwort anschließend zu bestätigen. Sobald Ihnen angezeigt wird, dass das Kennwort erfolgreich aktualisiert wurde, schließen Sie WSL innerhalb von PowerShell mit dem Befehl: exit.

Pakete aktualisieren und aufrüsten

Wir empfehlen, dass Sie Ihre Pakete regelmäßig mithilfe des bevorzugten Paket-Managers für die Distribution aktualisieren und upgraden. Verwenden Sie für Ubuntu oder Debian den folgenden Befehl:

sudo apt update && sudo apt upgrade

Windows führt für Ihre Linux-Verteilung(en) nicht automatisch eine Aktualisierung oder ein Upgrade aus. Dies ist eine Aufgabe, die die meisten Linux-Benutzer lieber selbst in die Hand nehmen.

Zusätzliche Distributionen hinzufügen

Um zusätzliche Linux-Distributionen hinzuzufügen, können Sie sie über den Microsoft Store, über den Befehl --import oder durch manuelles Installieren Ihrer eigenen benutzerdefinierten Distribution installieren. Sie möchten möglicherweise auch benutzerdefinierte WSL-Images zur unternehmensweiten Verteilung einrichten.

Windows einrichten Terminal

Windows Terminal kann jede Anwendung mit einer Befehlszeilenschnittstelle ausführen. Zu den Hauptmerkmalen gehören mehrere Registerkarten, Bereiche, Unterstützung für Unicode- und UTF-8-Zeichen, eine GPU-beschleunigte Engine zum Rendern von Text sowie die Möglichkeit, eigene Designs zu erstellen und Text, Farben, Hintergründe und Tastenkombinationen anzupassen.

Jedes Mal, wenn eine neue WSL-Linux-Distribution installiert wird, wird dafür im Windows Terminal eine neue Instanz erstellt, die Sie nach Ihren Wünschen anpassen können.

Wir empfehlen, WSL mit Windows Terminal zu verwenden, insbesondere wenn Sie mit mehreren Befehlszeilen arbeiten möchten. In der Windows Terminal-Dokumentation finden Sie Hilfe beim Einrichten und Anpassen Ihrer Einstellungen, einschließlich:

Windows-TerminalScreenshot

Dateispeicher

  • Um Ihr WSL-Projekt im Windows-Datei-Explorer zu öffnen, geben Sie Folgendes ein: explorer.exe .

    Achten Sie darauf, den Punkt am Ende des Befehls einzufügen, um das aktuelle Verzeichnis zu öffnen.

  • Speichern Sie Ihre Projektdateien im selben Betriebssystem wie die Tools, die Sie verwenden möchten.

    Wenn Sie Ihre Dateien mit Linux-Tools in einer Linux-Befehlszeile (Ubuntu, OpenSUSE usw.) bearbeiten, speichern Sie diese im WSL-Dateisystem, um die schnellste Leistung zu erzielen. Wenn Sie in einer Windows-Kommandozeile (PowerShell, Eingabeaufforderung) und mit Windows-Tools arbeiten, speichern Sie Ihre Dateien im Windows-Dateisystem. Auf Dateien kann auf allen Betriebssystemen zugegriffen werden, aber dies kann die Leistung erheblich verlangsamen.

Wenn Sie z. B. die WSL-Projektdateien speichern:

  • Verwenden Sie das Stammverzeichnis des Linux-Dateisystems: \\wsl$\<DistroName>\home\<UserName>\Project
  • Nicht das Stammverzeichnis des Windows-Dateisystems: C:\Users\<UserName>\Project oder /mnt/c/Users/<UserName>/Project$

Windows-Datei-Explorer mit Linux-Speicher

Einrichten Ihres bevorzugten Code-Editors

Wir empfehlen, Visual Studio Code oder Visual Studio zu verwenden, da sie die Remoteentwicklung und das Debuggen mit WSL direkt unterstützen. Mit Visual Studio Code können Sie WSL als vollwertige Entwicklungsumgebung verwenden. Visual Studio bietet native WSL-Unterstützung für die plattformübergreifende C++-Entwicklung.

Visual Studio Code verwenden

Befolgen Sie diese Schritt-für-Schritt-Anleitung, um mit Visual Studio Code und WSL zu beginnen, einschließlich der Installation der WSL-Erweiterung. Mit dieser Erweiterung können Sie WSL als vollständige Entwicklungsumgebung direkt aus VS Code verwenden. Wechseln Sie schnell zwischen verschiedenen, separaten Entwicklungsumgebungen, und führen Sie Updates durch, ohne sich Gedanken über die Auswirkungen auf Ihren lokalen Computer machen zu müssen.

Nach der Installation und Einrichtung von VS Code können Sie Ihr WSL-Projekt über einen VS Code-Remoteserver öffnen, indem Sie Folgendes eingeben: code .

Stellen Sie sicher, dass Sie den Punkt am Ende des Befehls hinzufügen, um das aktuelle Verzeichnis zu öffnen.

VS Code mit angezeigten WSL-Erweiterungen

Verwenden von Visual Studio

Folgen Sie dieser Schritt-für-Schritt-Anleitung, um mit der Verwendung von Visual Studio mit WSL für die plattformübergreifende C++-Entwicklung zu beginnen. Mit Visual Studio 2022 können Sie CMake-Projekte unter Windows, WSL-Distributionen und SSH-Verbindungen aus derselben Instanz von Visual Studio erstellen und debuggen.

Wählen Sie in Visual Studio 2022 ein Zielsystem aus

Einrichten der Versionsverwaltung mit Git

Folgen Sie dieser Schritt-für-Schritt-Anleitung, um mit Git in WSL zu beginnen, Ihr Projekt mit dem Git-Versionskontrollsystem zu verbinden sowie den Anmeldeinformations-Manager für die Authentifizierung, Git-Ignore-Dateien, Git-Zeilenenden und die in VS Code integrierten Git-Befehle zu verwenden.

Git-Version in der Befehlszeile anzeigen

Einrichten von Remote-Entwicklungscontainern mit Docker

Folgen Sie dieser Schritt-für-Schritt-Anleitung, um mit Docker-Remotecontainern unter WSL 2 erste Schritte zu machen und Ihr Projekt mit einem Remote-Entwicklungscontainer in Docker Desktop für Windows zu verbinden.

Screenshot von Docker Desktop

Einrichten einer Datenbank

Folgen Sie dieser Schritt-für-Schritt-Anleitung, um Erste Schritte mit Datenbanken in WSL auszuführen und Ihr Projekt in der WSL-Umgebung mit einer Datenbank zu verbinden. Führen Sie erste Schritte mit MySQL, PostgreSQL, MongoDB, Redis, Microsoft SQL Server oder SQLite aus.

MongoDB unter Ubuntu mit WSL ausführen

Einrichten der GPU-Beschleunigung für schnellere Leistung

Folgen Sie dieser Schritt-für-Schritt-Anleitung, um GPU-beschleunigtes Training für maschinelles Lernen in WSL einzurichten und die GPU (Grafikprozessor) Ihres Computers zu verwenden, um rechenintensive Workloads zu beschleunigen.

GPU-Beschleunigung mit WSL ausführen

Grundlegende WSL-Befehle

Die Linux-Distributionen, die Sie über WSL installieren, werden am besten mithilfe von PowerShell oder der Windows-Eingabeaufforderung (CMD) verwaltet. Eine Liste der grundlegenden Befehle, die Sie bei der Verwendung von WSL kennen sollten, finden Sie im Referenzhandbuch für WSL-Befehle.

Darüber hinaus sind viele Befehle zwischen Windows und Linux kompatibel. Hier sind einige Beispiele angegeben:

  • Führen Sie Linux-Tools über eine Windows-Befehlszeile aus: Öffnen Sie PowerShell, und zeigen Sie den Inhalt des Verzeichnisses C:\temp> mit dem Linux-Befehl ls -la an, indem Sie Folgendes eingeben: wsl ls -la

  • Linux- und Windows-Befehle kombinieren: In diesem Beispiel wird der Linux-Befehl ls -la verwendet, um die Dateien im Verzeichnis aufzulisten, und anschließend wird der PowerShell-Befehl findstr verwendet, um die Ergebnisse nach Wörtern zu filtern, die „git“ enthalten: wsl ls -la | findstr "git". Dies könnte auch durch die Kombination des Windows-Befehls dir mit dem Linux-Befehl grep erfolgen: dir | wsl grep git.

  • Ein Windows-Tool direkt über die WSL-Befehlszeile ausführen: <tool-name>.exe Geben Sie beispielsweise Folgendes ein, um Ihre .bashrc-Datei (das Shell-Skript, das immer dann ausgeführt wird, wenn Ihre Linux-Befehlszeile gestartet wird) zu öffnen: notepad.exe .bashrc

  • Führen Sie das Windows-Tool ipconfig.exe mit dem Linux-Tool grep aus: Geben Sie in Bash den Befehl ipconfig.exe | grep IPv4 | cut -d: -f2 oder in PowerShell ipconfig.exe | wsl grep IPv4 | wsl cut -d: -f2 ein. Dieses Beispiel zeigt, wie das ipconfig-Tool im Windows-Dateisystem verwendet wird, um die aktuellen TCP/IP-Netzwerkkonfigurationswerte anzuzeigen und anschließend mit grep, einem Linux-Tool, so zu filtern, dass nur das IPv4-Ergebnis ausgegeben wird.

Einbinden eines externen Laufwerks oder USB

Folgen Sie dieser Schritt-für-Schritt-Anleitung, um mit dem Einbinden eines Linux-Datenträgers in WSL 2 zu beginnen.

Screenshot des Befehls „wsl mount“

Ausführen von Linux-GUI-Apps

Folgen Sie diesem Tutorial, um zu lernen, wie Sie Linux-GUI-Apps unter WSL einrichten und ausführen.

Zusätzliche Ressourcen