Co to jest Git LFS i kiedy go potrzebujesz?

Question

Accepted Answer

**Git LFS** (Large File Storage) to rozszerzenie dla Git służące do efektywnego obsługiwania **dużych plików binarnych** (wideo, zbiory danych, zasoby projektowe, duże binaria) w repozytorium. Git jest zaprojektowany dla tekstu i kodu źródłowego, a obsługuje duże binaria słabo, dlatego LFS przechowuje je osobno, utrzymując jedynie lekkie odniesienia w repozytorium.

## Problem: Git i duże binaria

```text
Git stores every version of every file in its history (the full content):
  → LARGE BINARY files (videos, datasets, PSDs, big binaries) bloat the repo ENORMOUSLY:
    - every change stores another full copy (binaries don't diff well)
    - the repo and EVERY clone become huge and slow (clone/fetch download all history)
    - history can't be shrunk easily (the large blobs are permanent)
→ Git is great for source code (text, diffable), POOR for large binaries.
```

## Jak działa Git LFS

```text
Git LFS replaces large files in the repo with small POINTER files (a reference/hash),
and stores the ACTUAL large files on a separate LFS server:
  → the Git repo stays small (just pointers in history)
  → the actual large files are downloaded on demand (only the versions you need)
→ You work normally; LFS transparently swaps pointers ↔ real files.
```

```bash
git lfs install                    # set up LFS
git lfs track "*.psd"             # track a file type with LFS (records in .gitattributes)
git lfs track "*.mp4"
git add .gitattributes
# now large files of these types go to LFS automatically (pointers in Git)
git lfs ls-files                   # list LFS-tracked files
```

## Kiedy go używać

```text
✓ Repos with large binaries: media (video/audio/images), datasets, game assets,
  design files (PSD/Sketch), large compiled artifacts, ML models
✗ Pure source code repos don't need it (Git handles text well)
Alternatives: don't store large artifacts in Git at all (use artifact stores, S3,
  package registries) — sometimes the better choice.
```

## Dlaczego to ważne

Zrozumienie Git LFS to cenną wiedzę na poziomie seniora dla **obsługi dużych plików binarnych w Git** — rzeczywisty problem dla niektórych projektów, dlatego jest praktyczną i użyteczną wiedzą.

Hasło problemu polega na tym, że **Git obsługuje duże binaria słabo**: ponieważ Git przechowuje każdą wersję każdego pliku w historii, a binaria nie poddają się dobrze diffingowi (każda zmiana przechowuje kolejną pełną kopię), duże pliki binarne (wideo, zbiory danych, zasoby projektowe, duże artefakty) **nieznacznie zwiększają rozmiar repozytorium** — sprawiając, że repo i każdy jego klon są ogromne i wolne, a przerost jest trwały i trudny do usunięcia.

To jest rzeczywisty, czasem poważny problem dla projektów obejmujących media, zbiory danych, zasoby gier, pliki projektowe lub modele ML. **Git LFS** rozwiązuje go poprzez przechowywanie dużych plików **osobno** (na serwerze LFS) przy zachowaniu jedynie małych **plików wskaźnikowych** w historii Git — dzięki czemu repozytorium pozostaje małe i lekkie, a rzeczywiste duże pliki są pobierane na żądanie (tylko potrzebne wersje).

Zrozumienie, jak to działa (wskaźniki w Git, rzeczywiste pliki w LFS, przezroczyste zamianę) i jak go używać (śledzenie typów plików poprzez `.gitattributes`) to praktyczna wiedza dla projektów, które tego potrzebują.

Również ważna jest ocena dotycząca **kiedy go używać** (repozytoria z dużymi binariami) w stosunku do sytuacji, gdy jest niepotrzebny (czysty kod źródłowy, gdzie Git dobrze obsługuje tekst) oraz świadomość **alternatyw** (czasem niechowaniem dużych artefaktów w Git wcale — zamiast tego korzystanie z magazynów artefaktów, S3 lub rejestrów pakietów — jest lepszym wyborem).

To odzwierciedla zdolność do podejmowania słusznych decyzji w kwestii zarządzania dużymi plikami.

Ponieważ niektóre projekty rzeczywiście mają trudności z powiększaniem się Git z powodu dużych binarnych (rzeczywisty, mający wpływ problem) i ponieważ Git LFS (lub alternatywy) jest rozwiązaniem — utrzymując repozytoria w dobrej kondycji przy jednoczesnym obsługiwaniu dużych plików — zrozumienie Git LFS, problemu, który rozwiązuje, jak działa i kiedy go używać w stosunku do alternatyw, jest cenną wiedzą na poziomie seniora dla efektywnego zarządzania repozytoriami z dużymi plikami, przydatnym tematem dla projektów obejmujących media, dane lub duże zasoby.