macOS-.gitignore-Vorlage erklärt

macOS.gitignore blockiert Metadatendateien, die der Finder und das macOS-Dateisystem ohne Wissen der Nutzer anlegen. Da sie nichts mit dem Projektinhalt zu tun haben, wird eigentlich empfohlen, diese Vorlage nicht ins Repository, sondern in eine persönliche globale gitignore (core.excludesFile) zu legen.

In der Praxis richten nicht alle Teammitglieder eine globale Einstellung ein, sodass versehentlich committete .DS_Store-Dateien häufig sind. Viele Teams nehmen die Vorlage deshalb zusätzlich in die Projekt-.gitignore auf.

Regeln im Einzelnen

Muster	Was ignoriert wird und warum
.DS_Store.localized	Finder-Metadaten.DS_Store ist die Datei mit Ansichtseinstellungen (Symbolposition, Sortierung), die der Finder in jedem Ordner anlegt. Sie entsteht schon beim bloßen Öffnen eines Ordners und enthält eine Liste der Dateinamen, wodurch unbeabsichtigt Informationen preisgegeben werden können.
._*.AppleDouble.LSOverride	Resource Forks (AppleDouble)Begleitdateien ._Dateiname, die beim Kopieren auf Nicht-HFS+/APFS-Volumes (FAT, Netzwerkfreigaben) angelegt werden, um erweiterte Attribute zu speichern.
.VolumeIcon.icns	Benutzerdefinierte SymboleVolume-Symboldatei. Benutzerdefinierte Ordnersymbole werden in einer Datei Icon gespeichert, deren Name mit einem Wagenrücklaufzeichen (CR) endet; die Vorlage erfasst sie mit einem Klammermuster der Form Icon[\r].
.Spotlight-V100.fseventsd.Trashes.TemporaryItems.DocumentRevisions-V100	Systemindex und PapierkorbSpotlight-Index, Ereignisprotokoll des Dateisystems, Papierkorb und Speicher für Dokumentversionen, die im Stammverzeichnis externer Laufwerke oder Volumes entstehen.
.com.apple.timemachine.donotpresent.com.apple.timemachine.supportedBackups.backupdb.MobileBackups	Time MachineMarkierungsdateien und Sicherungsordner, die auf einem Time-Machine-Sicherungslaufwerk entstehen.
.AppleDB.AppleDesktopNetwork Trash FolderTemporary Items.apdisk	AFP-FreigabeordnerDatenbank und Ordner, die ein AFP-Dateiserver (Apple Filing Protocol) auf freigegebenen Volumes anlegt. Auch wenn der Name Leerzeichen enthält, wird das gitignore-Muster unverändert geschrieben.
__MACOSX/	Nebenprodukte beim EntpackenResource-Fork-Ordner, der entsteht, wenn ein unter macOS erstelltes zip mit einem anderen Werkzeug entpackt wird.

Hinweise für die Praxis

• Globale Einstellung: Nach git config --global core.excludesFile ~/.gitignore_global fügen Sie diese Vorlage in jene Datei ein. Ohne diese Einstellung verwendet git den Standardpfad ~/.config/git/ignore.
• Bereits committete .DS_Store-Dateien entfernen Sie mit git rm --cached. Im Tab Tracking aufheben erledigt der Modus „Alle verfolgten Dateien, auf die die .gitignore zutrifft“ das in einem Schritt.
• Die Regel ._* blockiert nicht alle Dateien, die mit einem Unterstrich beginnen, sondern nur Namen, die mit ._ (Punkt + Unterstrich) beginnen.

Originalvorlage

# General.DS_Store.localized__MACOSX/.AppleDouble.LSOverrideIcon[
]# Resource forks._*# Files and directories that might appear in the root of a volume.DocumentRevisions-V100.fseventsd.Spotlight-V100.TemporaryItems.Trashes.VolumeIcon.icns.com.apple.timemachine.donotpresent.com.apple.timemachine.supported.PKInstallSandboxManager.PKInstallSandboxManager-SystemSoftware.hotfiles.btree.vol.file.disk_label*lost+found.HFS+ Private Directory Data[
]# Directories potentially created on remote AFP share.AppleDB.AppleDesktopNetwork Trash FolderTemporary Items.apdisk# Mac OS 6 to 9Desktop DBDesktop DFTheFindByContentFolderTheVolumeSettingsFolder.FBCIndex.FBCSemaphoreFile.FBCLockFolder# Quota system.quota.group.quota.user.quota.ops.group.quota.ops.user# TimeMachineBackups.backupdb.MobileBackups.MobileBackups.trashMobileBackups.trashtmbootpicker.efi

Häufig kombinierte Vorlagen

Weitere Vorlagenerklärungen