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.jsonan mit den Build-Befehlen Ihres Projekts - Erstellen und passen Sie
.vscode/launch.jsonan mit korrekten Pfaden zu Ihren ausführbaren Dateien - Für Mono: Runtime installieren und mit
mono --versionverifizieren - 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.