Wie richte ich in Sublime Text einen Build-System-Befehl für meine Programmiersprache ein?
- Einleitung und Voraussetzungen
- Erstellen der Build-Datei
- Beispielkonfigurationen
- Arbeitsverzeichnis und Umgebungsvariablen
- Fehlererkennung und Ausgabeformat
- Auswählen und Ausführen des Build-Systems
- Feinheiten und Debugging
Einleitung und Voraussetzungen
Um in Sublime Text ein eigenes Build-System für deine Programmiersprache einzurichten, brauchst du grundlegende Kenntnisse über die Kommandozeile deines Betriebssystems und darüber, wie dein Compiler/Interpreter aufgerufen wird. Stelle sicher, dass der ausführbare Befehl (z. B. python, java, gcc oder ein eigener Interpreter) im PATH verfügbar ist oder du den vollen Pfad angeben kannst. Du kannst Build-Systeme ab Sublime Text 3 und 4 auf dieselbe Weise anlegen.
Erstellen der Build-Datei
Öffne Sublime Text und wähle im Menü Tools → Build System → New Build System…. Dadurch öffnet sich eine neue Datei mit einer JSON-Vorlage. Ersetze den Inhalt durch eine Konfiguration, die den Aufruf deines Compilers/Interpreters definiert. Typische Felder sind "cmd", "file_regex", "working_dir", "selector" und optional "variants" oder "env". "cmd" ist ein Array mit dem auszuführenden Befehl und seinen Argumenten; benutze "$file" für den aktuellen Dateipfad, "$file_base_name" für den Dateinamen ohne Erweiterung und "$file_extension" bei Bedarf. Speichere die Datei im vorgeschlagenen Verzeichnis unter einem aussagekräftigen Namen mit der Endung .sublime-build.
Beispielkonfigurationen
Für einen Interpreter, der die aktuelle Datei ausführt, könnte "cmd" wie aussehen. Wenn du zuerst kompilieren und dann ausführen möchtest, kannst du Varianten definieren, z. B. eine Variante "Run" für den Interpreteraufruf und die Hauptdefinition für den Kompiliervorgang; Sublime zeigt Varianten nach dem Buildbefehl an. Für Windows-Pfade oder Batch-Aufrufe kann es nötig sein, die Shell zu aktivieren mittels "shell_cmd" statt "cmd" oder "shell": true. Wenn Fehlermeldungen einen bestimmten Format haben, definiere "file_regex", damit Sublime klickbare Fehlermeldungen erkennt (z. B. "file_regex": "^(...):( +):( +): (.*)$").
Arbeitsverzeichnis und Umgebungsvariablen
Setze "working_dir": "$file_path", wenn das aktuelle Dateiverzeichnis als Arbeitsverzeichnis dienen soll. Du kannst über "env" Umgebungsvariablen spezifizieren, die für den Build gelten, z. B. PATH-Anpassungen oder spezielle Flags.
Fehlererkennung und Ausgabeformat
Definiere "file_regex", damit Sublime Fehler- und Warnmeldungen parsen und zu passenden Codezeilen springen kann. Passe den regulären Ausdruck an das Ausgabeformat deines Compilers an. Teste mit absichtlichen Fehlern, um sicherzustellen, dass die Verlinkung zu Quelle und Zeile korrekt funktioniert.
Auswählen und Ausführen des Build-Systems
Nach dem Speichern wähle Tools → Build System und klicke auf den Namen deiner .sublime-build-Datei oder stelle auf Automatic, wenn dein "selector" korrekt gesetzt ist (z. B. "selector": "source.meineSprache"). Starte den Build mit Tools → Build oder dem Shortcut (Strg/Cmd+B). Für Varianten benutze Tools → Build With... (Strg/Cmd+Shift+B), um eine bestimmte Variante auszuwählen.
Feinheiten und Debugging
Wenn der Build nicht wie erwartet läuft, öffne die Konsole (View → Show Console) um Fehlermeldungen anzusehen. Prüfe Pfade, Rechte und ob der Interpreter im PATH liegt. Achte bei Windows auf Anführungszeichen und Escape-Zeichen. Nutze "shell_cmd" für komplexere Shell- Konstrukte oder Pipe-Operationen.