Leitfaden zur Einrichtung der Windsurf-Entwicklungsumgebung
Übersicht
- .NET / C# – Zielumgebungen sind sowohl .NET Core als auch .NET Framework (über Mono)
- C / C++ – mit clang‑basiertem Tooling
⚠️ Wichtig: Die folgenden Beispiele sind Vorlagen, die Sie für Ihr spezifisches Projekt anpassen müssen. Passen Sie Dateipfade, Projektnamen und Build‑Befehle an, damit sie zu Ihrer Codebasis passen.
1. .NET / C#-Entwicklung
Wählen Sie die Variante, die zu Ihrem Codebase passt.
.NET Core / .NET 6+
-
C# (
muhammad-sammy.csharp
) – bündelt OmniSharp LS und NetCoreDbg, sodass Sie sofort mit F5 starten können -
.NET Install Tool (
ms-dotnettools.vscode-dotnet-runtime
) – installiert fehlende Runtimes/SDKs automatisch -
Solution Explorer (
fernandoescolar.vscode-solution-explorer
) – .NET-Lösungen und -Projekte navigieren und verwalten
dotnet build
.NET Framework über Mono
- Mono Debug (
chrisatwindsurf.mono-debug
) – Debug-Adapter für Mono (Open VSX) - C# (
muhammad-sammy.csharp
) für Sprachfunktionen
⚠️ .NET-Framework-Konfiguration: Nachdem Sie Mono installiert haben, müssen Sie, um die C#-Erweiterung mit .NET‑Framework‑Projekten zu verwenden, eine bestimmte Einstellung in den IDE‑Einstellungen umschalten. Gehen Sie zu Settings (im Abschnitt der C#‑Erweiterung) und deaktivieren Sie „Omnisharp: Use Modern Net“. Diese Einstellung verwendet den OmniSharp‑Build für .NET 6, der erhebliche Leistungsverbesserungen für Projekte im SDK‑Stil, .NET Core und .NET 5+ bietet. Beachten Sie, dass diese Version keine .NET‑Framework‑Projekte im Nicht‑SDK‑Stil unterstützt, einschließlich Unity.Build:
mcs Program.cs
Konfigurieren Sie tasks.json
für Ihr Projekt
.vscode/tasks.json
im Stammverzeichnis Ihres Workspace erstellen bzw. bearbeiten und diese Vorlagen anpassen:
launch.json
für das Debugging konfigurieren
.vscode/launch.json
im Workspace-Stammverzeichnis erstellen bzw. bearbeiten und die Pfade aktualisieren:
CLI-Entsprechungen
Einschränkungen des .NET Framework
- Verwenden Sie Windsurf zusammen mit Visual Studio für Codegenerierung und Bearbeitung
- Migrieren Sie nach Möglichkeit kompatible Teile zu .NET Core
2. C/C++-Entwicklung
Erweiterung | Zweck |
---|---|
Windsurf C++ Tools (Codeium.windsurf-cpptools ) | Ein Bundle der drei Erweiterungen, die wir für den Einstieg empfehlen. Enthält C/C++‑LSP‑Unterstützung, Debugging‑Unterstützung und CMake‑Unterstützung. |
Hinweis: Durch die Installation des Bundles Windsurf C++ Tools werden die unten aufgeführten einzelnen Erweiterungen automatisch mitinstalliert. Es genügt, das Bundle zu installieren.
Erweiterung | Zweck |
---|---|
clangd (llvm-vs-code-extensions.vscode-clangd ) | Integration des clangd‑Language Servers. Wenn clangd fehlt, wird angeboten, die passende Binärdatei für Ihre Plattform herunterzuladen. |
CodeLLDB (vadimcn.vscode-lldb ) | Nativer Debugger auf Basis von LLDB für C/C++ und Rust. |
CMake Tools (ms-vscode.cmake-tools ) | Projektkonfiguration sowie Build‑, Test‑ und Debug‑Integration für CMake‑basierte Projekte. |
make
, ninja
usw. über benutzerdefinierte tasks.json
‑Ziele aufrufen.
C/C++-Buildaufgaben konfigurieren
.vscode/tasks.json
für Ihr C/C++-Projekt:
3. Hinweise & Fallstricke
- Nur Open‑Source – lehnen Sie jede Aufforderung ab, proprietäre Microsoft‑Tools zu installieren; Windsurf‑Container dürfen diese nicht enthalten.
- Container vs. Host – SDKs/Compiler müssen innerhalb des Windsurf‑Workspace‑Containers vorhanden sein.
- Tastenkürzel
- Ctrl/⌘ + Shift + B → mit der aktiven Build‑Aufgabe kompilieren
- F5 → mit der ausgewählten
launch.json
‑Konfiguration debuggen
4. Einrichtungs-Checkliste
- Installieren Sie die erforderlichen Erweiterungen für Ihren Sprach‑Stack
- Erstellen und passen Sie
.vscode/tasks.json
an mit den Build-Befehlen Ihres Projekts - Erstellen und passen Sie
.vscode/launch.json
an mit korrekten Pfaden zu Ihren ausführbaren Dateien - Für Mono: Runtime installieren und mit
mono --version
verifizieren - Aktualisieren Sie Dateipfade, Projektnamen und Build-Argumente, damit sie zu Ihrer Codebasis passen
- Testen Sie Ihre Einrichtung: Drücken Sie Ctrl/⌘ + Shift + B zum Erstellen, dann F5 zum Debuggen
💡 Tipp: Die Konfigurationsdateien sind projektspezifisch. Sie müssen die obigen Beispiele für jedes Workspace anpassen.