.gitattributes : fichier .gitattributes

Le .gitattributes associe des comportements précis à des chemins ou motifs de fichiers particuliers dans un dépôt Git, au-delà du simple suivi ou non-suivi que gère le .gitignore : normalisation des fins de ligne, désignation de fichiers comme binaires pour éviter une fusion textuelle incohérente, filtres de fusion personnalisés, ou redirection de certains fichiers vers Git LFS (Large File Storage).

Le cas d’usage le plus fréquent normalise les fins de ligne entre systèmes d’exploitation : une règle comme * text=auto demande à Git de convertir automatiquement les fins de ligne selon la convention de la plateforme locale à l’extraction, tout en les stockant de façon cohérente dans l’historique du dépôt. Ce mécanisme évite qu’un même fichier texte apparaisse comme modifié uniquement à cause d’une différence de convention entre Windows (CRLF) et un système Unix (LF).

Le fichier est également le mécanisme de déclaration indispensable de Git LFS : c’est lui qui indique quels motifs de fichiers (souvent des extensions binaires volumineuses comme les vidéos, les modèles 3D ou les gros jeux de données) doivent être gérés par ce système d’extension plutôt que stockés directement dans l’historique Git classique. Sans cette déclaration explicite, Git LFS n’intercepterait aucun fichier correspondant, quelle que soit sa taille réelle.

Contrairement au .gitignore, qui ne fait qu’exclure des fichiers du suivi, le .gitattributes modifie le comportement de Git sur des fichiers qui restent activement suivis. Cette distinction de rôle explique pourquoi les deux fichiers coexistent fréquemment dans un même projet sans se chevaucher fonctionnellement.