Plantilla .gitignore de macOS explicada

macOS.gitignore bloquea los archivos de metadatos que el Finder y el sistema de archivos de macOS crean sin que el usuario lo note. Como no tienen relación con el contenido del proyecto, en principio se recomienda poner esta plantilla en un gitignore global personal (core.excludesFile) y no en el repositorio.

En la práctica, como no todos los miembros del equipo hacen la configuración global, es frecuente que se confirme un .DS_Store por accidente. Por eso muchos equipos la incluyen también en el .gitignore del proyecto.

Explicación regla por regla

Patrón	Qué ignora y por qué
.DS_Store.localized	Metadatos del Finder.DS_Store es el archivo con la configuración de visualización (posición de iconos, orden) que el Finder crea en cada carpeta. Aparece con solo abrir la carpeta y, como contiene la lista de nombres de archivos, puede revelar información sin querer.
._*.AppleDouble.LSOverride	Bifurcaciones de recursos (AppleDouble)Son los archivos pareja ._nombre que se crean para guardar los atributos extendidos al copiar archivos a volúmenes que no son HFS+ ni APFS (FAT, recursos compartidos de red).
.VolumeIcon.icns	Iconos personalizadosEs el archivo de icono del volumen. Los iconos personalizados de carpetas se guardan en un archivo Icon con un carácter de retorno de carro (CR) al final del nombre, y la plantilla lo captura con un patrón de corchetes de la forma Icon[\r].
.Spotlight-V100.fseventsd.Trashes.TemporaryItems.DocumentRevisions-V100	Índices del sistema y papeleraSon el índice de Spotlight, el registro de eventos del sistema de archivos, la papelera y el almacén de versiones de documentos que aparecen en discos externos o en la raíz de los volúmenes.
.com.apple.timemachine.donotpresent.com.apple.timemachine.supportedBackups.backupdb.MobileBackups	Time MachineSon los archivos marcadores y las carpetas de copia de seguridad que aparecen en el disco de copias de Time Machine.
.AppleDB.AppleDesktopNetwork Trash FolderTemporary Items.apdisk	Carpetas compartidas por AFPSon las bases de datos y carpetas que crea un servidor de archivos AFP (Apple Filing Protocol) en los volúmenes compartidos. Aunque el nombre tenga espacios, el patrón de gitignore se escribe tal cual.
__MACOSX/	Subproductos de descompresiónEs la carpeta de bifurcaciones de recursos que aparece al descomprimir con otras herramientas un zip creado en macOS.

Precauciones en la práctica

• Configuración global: ejecuta git config --global core.excludesFile ~/.gitignore_global y pon esta plantilla en ese archivo. Si no lo configuras, se usa la ruta predeterminada ~/.config/git/ignore.
• Los .DS_Store ya confirmados se quitan con git rm --cached . En la pestaña Dejar de rastrear, el modo “Todos los archivos rastreados que coinciden con .gitignore” los procesa de una vez.
• La regla ._* no bloquea todos los archivos que empiezan por guion bajo. Solo afecta a los nombres que empiezan por ._ (punto + guion bajo).

Plantilla original

# 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

Plantillas que suelen usarse juntas

Otras plantillas explicadas