Git zur Verarbeitung von Zeilenabschlüssen konfigurieren

Every time you press return on your keyboard you insert an invisible character called a line ending. Different operating systems handle line endings differently.

When you're collaborating on projects with Git and GitHub Enterprise, Git might produce unexpected results if, for example, you're working on a Windows machine, and your collaborator has made a change in OS X.

You can configure Git to handle line endings automatically so you can collaborate effectively with people who use different operating systems.

Globale Einstellungen für Zeilenabschlüsse

Mit dem Befehl git config core.autocrlf können Sie ändern, wie Git Zeilenabschlüsse verarbeitet. Dazu ist ein einziges Argument nötig.

$ git config --global core.autocrlf input
# Configure Git to ensure line endings in files you checkout are correct for OS X

$ git config --global core.autocrlf true
# Configure Git to ensure line endings in files you checkout are correct for Windows.
# For compatibility, line endings are converted to Unix style when you commit files.

$ git config --global core.autocrlf input
# Configure Git to ensure line endings in files you checkout are correct for Linux

Repository-abhängige Einstellungen

Optionally, you can configure a .gitattributes file to manage how Git reads line endings in a specific repository. When you commit this file to a repository, it overrides the core.autocrlf setting for all repository contributors. This ensures consistent behavior for all users, regardless of their Git settings and environment.

Die Datei .gitattributes muss im Root des Repositorys erstellt und wie jede andere Datei committet werden.

Eine .gitattributes-Datei sieht wie eine Tabelle mit zwei Spalten aus:

• Links ist der Dateiname, den Git abgleichen soll.
• Rechts befindet sich die Konfiguration für Zeilenabschlüsse, die Git für diese Dateien verwenden soll.

Beispiel

Hier sehen Sie ein Beispiel für eine .gitattributes-Datei. You can use it as a template for your repositories:

# Legen Sie das Standardverhalten für den Fall fest, wenn jemand keine core.autocrlf festgelegt haben.
* text=auto

# Geben Sie explizit Textdateien an, die beim Auschecken immer normalisiert und in
# native Zeilenabschlüsse umgewandelt werden sollen.
*.c text
*.h text

# Geben Sie Dateien an, die beim Auschecken immer CRLF-Zeilenabschlüsse haben werden.
*.sln text eol=crlf

# Führen Sie alle Dateien auf, die wirklich binär sind und nicht geändert werden sollten.
*.png binary
*.jpg binary

You'll notice that files are matched—*.c, *.sln, *.png—, separated by a space, then given a setting—text, text eol=crlf, binary. We'll go over some possible settings below.

• text=auto Git will handle the files in whatever way it thinks is best. Das ist eine gute Standardoption.

• text eol=crlf Git will always convert line endings to CRLF on checkout. Verwenden Sie diese Einstellung für Dateien, die die CRLF-Abschlüsse behalten sollen, auch unter OS X oder Linux.

• text eol=lf Git will always convert line endings to LF on checkout. Verwenden Sie diese Einstellung für Dateien, die die LF-Abschlüsse behalten sollen, auch unter Windows.

• binary Git will understand that the files specified are not text, and it should not try to change them. Die Einstellung binary ist auch ein Alias für -text -diff.

Ein Repository nach dem Ändern der Zeilenabschlüsse aktualisieren

When you set the core.autocrlf option or commit a .gitattributes file, you may find that Git reports changes to files that you have not modified. Git has changed line endings to match your new configuration.

To ensure that all the line endings in your repository match your new configuration, backup your files with Git, delete all files in your repository (except the .git directory), then restore the files all at once.

1. Speichern Sie Ihre aktuellen Dateien in Git, damit nichts von Ihrer Arbeit verloren geht.

   $ git add . -u
   $ git commit -m "Saving files before refreshing line endings"

2. Fügen Sie alle geänderten Dateien wieder hinzu, und normalisieren Sie die Zeilenabschlüsse.

   $ git add --renormalize .

3. Zeigen Sie die umgeschriebenen, normalisierten Dateien an.

   $ git status

4. Committen Sie die Änderungen an Ihr Repository.

   $ git commit -m "Normalize all the line endings"

Weiterführende Informationen

• Customizing Git - Git Attributes in the Pro Git book
• git-config in the man pages for Git
• Getting Started - First-Time Git Setup in the Pro Git book
• Mind the End of Your Line by Tim Clem