Wie löse ich Probleme mit Zeilenenden (CRLF vs LF) in Cygwin-Skripten?

1. Hintergrund zu Zeilenenden
2. Symptome von Zeilenendenproblemen
3. Erkennung des Problems
4. Konvertierung der Zeilenenden
5. Einstellung von Git und Cygwin
6. Vorbeugung und best practices
7. Fazit

Hintergrund zu Zeilenenden

Wenn man Skripte unter Cygwin verwendet, können Probleme mit den Zeilenenden auftreten, da Windows und Unix/Linux unterschiedliche Standard-Zeilenendungen nutzen. Windows verwendet eine Kombination aus Wagenrücklauf und Zeilenvorschub (CRLF, also \r\n), während Unix-ähnliche Systeme wie Linux oder die Cygwin-Umgebung nur den Zeilenvorschub (LF, also \n) verwenden. Dieses unterschiedliche Verhalten führt häufig dazu, dass Skripte, die mit einem Windows-Editor erstellt oder bearbeitet wurden, bei der Ausführung in Cygwin Fehler werfen oder nicht korrekt laufen.

Symptome von Zeilenendenproblemen

Typische Symptome sind etwa die Fehlermeldung command not found, ungewöhnliche Syntaxfehler direkt beim Interpretieren des Skripts oder das Auftauchen von merkwürdigen versteckten Zeichen, etwa am Zeilenende. Im konkreten Fall von Shell-Skripten führt ein Windows-CR (\r) häufig dazu, dass der Interpreter das Skript nicht richtig versteht.

Erkennung des Problems

Um festzustellen, ob ein Skript CRLF-Zeilenenden hat, kann man es mit Tools in Cygwin überprüfen. So zeigt der Befehl file häufig an, wenn ein Skript Windows-Zeilenenden nutzt. Ebenso lässt sich mit cat -v script.sh schauen, ob am Zeilenende die Zeichen ^M erscheinen, was dem Wagenrücklaufzeichen entspricht.

Konvertierung der Zeilenenden

Die übliche und wichtigste Maßnahme ist die Umwandlung der Zeilenenden von CRLF auf LF. Dafür existieren verschiedene Methoden. Das Tool dos2unix ist in Cygwin meist vorhanden oder kann nachinstalliert werden. Es konvertiert eine Datei direkt - also etwa:

Nach dieser Umwandlung sollten die Zeilenenden Unix-konform sein. Alternativ kann man auch sed verwenden, um die Wagenrücklaufzeichen zu entfernen:

Es lohnt sich ebenfalls, den Editor so zu konfigurieren, dass er beim Speichern schon die korrekten (LF) Zeilenenden benutzt. Beliebte Editoren wie Visual Studio Code, Notepad++ oder Sublime Text bieten diese Option.

Einstellung von Git und Cygwin

Falls das Skript aus einem Git-Repository stammt, sollte man darauf achten, dass Git die Zeilenenden korrekt behandelt. Git hat die Option core.autocrlf, die steuern kann, ob beim Checkout oder Commit die Zeilenenden automatisch angepasst werden. Unter Cygwin ist es oft sinnvoll, core.autocrlf=false zu setzen, um unerwartete Umwandlungen zu vermeiden. Alternativ hilft es, Git-Attribute zu nutzen, um Skripte als text oder binary zu markieren.

Cygwin selbst hat unterschiedliche Mount-Optionen, die Zeilenenden beeinflussen können. Historisch gab es einen text-Modus für die Laufwerke, der CRLF intelligent umwandelte. Heutzutage ist dies jedoch meist deaktiviert oder nicht empfohlen, da es zu Inkonsistenzen führt. Besser ist es, sich für die Skripte an ein durchgängiges Format (LF) zu halten und die Dateien explizit zu konvertieren.

Vorbeugung und best practices

Um spätere Probleme zu vermeiden, sollte man beim Erstellen und Bearbeiten der Skripte von Anfang an auf das richtige Zeilenendeformat achten. Idealerweise werden Skripte in einem Editor bearbeitet, der Unix-Zeilenenden speichert. Zudem kann man in Projekten eine .editorconfig verwenden, die den Zeilenendestandard für alle Entwickler vorgibt.

Wenn man Dateien zwischen Windows- und Cygwin-Umgebung austauscht, sollte stets die Konvertierung der Zeilenenden beachtet werden, sei es durch dos2unix, Editor-Optionen oder bei der Nutzung von Versionierungssystemen.

Fazit

Zeilenenden sind eine häufige Fehlerquelle bei der Entwicklung von Skripten unter Cygwin auf Windows-Systemen. Das zentrale Vorgehen besteht darin, die Dateien in das Unix-Format (LF) zu konvertieren. Werkzeuge wie dos2unix sind hierbei sehr hilfreich. Zusätzlich sollte die Ausgabe von Tools wie file und cat -v genutzt werden, um das Problem zu identifizieren. Wichtig ist es außerdem, den gesamten Workflow – von Editor, über Git, bis zur Ausführung in Cygwin – auf konsistente Zeilenenden zu prüfen, damit Probleme gar nicht erst auftreten.