Ignoruj zmiany plików za pomocą usługi Git

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2019 | Visual Studio 2022

Nie każdy plik w projekcie wymaga śledzenia przez usługę Git. Przykłady plików, które zwykle nie wymagają śledzenia, obejmują pliki tymczasowe ze środowiska projektowego, dane wyjściowe testów i dzienniki.

Możesz użyć kilku mechanizmów, aby poinformować usługę Git, które pliki w projekcie nie powinny być śledzone i aby upewnić się, że usługa Git nie zgłasza zmian w tych plikach. W przypadku plików, których Git nie śledzi, można użyć pliku .gitignore lub pliku exclude. W przypadku plików, które już śledzi usługa Git, możesz poinstruować usługę Git, aby przestała je śledzić i ignorować wszelkie zmiany.

Wymagania wstępne

Użyj pliku .gitignore

Możesz ustawić Git, aby nie śledzić niektórych plików w projekcie, dodając i konfigurując plik .gitignore. Zapoznaj się z następującymi kluczowymi punktami:

• Pliki nieśledzone: wpisy w .gitignore pliku mają zastosowanie tylko do nieśledzonych plików. Nie uniemożliwiają one usłudze Git raportowania zmian śledzonych plików. Śledzone pliki to pliki, które zostały zatwierdzone i istnieją w ostatniej migawce Git.
• Wzorce wyszukiwania plików: każdy wiersz w .gitignore pliku określa wzorzec wyszukiwania plików względem ścieżki .gitignore pliku. Składnia .gitignore jest elastyczna i obsługuje używanie symboli wieloznacznych do określania pojedynczych lub wielu plików według nazwy, rozszerzenia i ścieżki. Usługa Git dopasuje .gitignore wzorce wyszukiwania do plików w projekcie, aby określić, które pliki mają być ignorowane.
• Lokalizacja: zazwyczaj dodajesz .gitignore plik do folderu głównego projektu. Można jednak dodać plik .gitignore do dowolnego folderu projektu, aby poinformować Git, które pliki mają być ignorowane w tym folderze i jego podfolderach na dowolnej głębokości zagnieżdżenia. W przypadku wielu .gitignore plików wzorce .gitignore wyszukiwania plików określone w folderze mają pierwszeństwo przed wzorcami określonymi .gitignore przez plik w folderze nadrzędnym.
• Tworzenie: możesz ręcznie utworzyć .gitignore plik i dodać do niego wpisy wzorca pliku. Możesz też zaoszczędzić czas, .gitignore pobierając szablon dla środowiska deweloperskiego z repozytorium GitHub gitignore.
• Korzyści: Jedną z zalet korzystania z .gitignore pliku jest to, że można zatwierdzać zmiany i udostępniać je innym osobom.

• Opcja Ignoruj ten element lokalny dodaje nowy wpis do .gitignore pliku i usuwa wybrany plik z listy zmienionych plików.
• Opcja Ignoruj to rozszerzenie dodaje nowy wpis do .gitignore pliku i usuwa wszystkie pliki z tym samym rozszerzeniem co wybrany plik z listy zmienionych plików.

Każda z opcji tworzy plik, .gitignore jeśli jeszcze nie istnieje w folderze głównym repozytorium i dodaje do niego wpis.

Edytowanie pliku gitignore

Każdy wpis w .gitignore pliku to: wzorzec wyszukiwania plików określający, które pliki mają być ignorowane, komentarz rozpoczynający się od znaku numeru () lub pusty wiersz (#w celu zapewnienia czytelności). Składnia jest elastyczna .gitignore i obsługuje używanie symboli wieloznacznych do określania pojedynczych lub wielu plików według nazwy, rozszerzenia i ścieżki. Wszystkie ścieżki wzorców wyszukiwania plików są względem pliku .gitignore.

Oto kilka przykładów typowych wzorców wyszukiwania plików:

# Ignore all files with the specified name.
# Scope is all repo folders.
config.json

# Ignore all files with the specified extension.
# Scope is all repo folders.
*.json

# Add an exception to prevent ignoring a file with the specified name.
# Scope is all repo folders.
!package.json

# Ignore a file with the specified name.
# Scoped to the 'logs' subfolder.
/logs/test.logfile

# Ignore all files with the specified name.
# Scoped to the 'logs' subfolder and all folders beneath it.
/logs/**/test.logfile

# Ignore all files in the 'logs' subfolder.
/logs/

Gdy tylko zmodyfikujesz .gitignore plik, usługa Git aktualizuje listę plików, które ignoruje.

Użyj globalnego pliku .gitignore

Można wyznaczyć plik .gitignore jako globalny plik do ignorowania, który będzie stosowany we wszystkich lokalnych repozytoriach Git. Aby to zrobić, użyj polecenia git config w następujący sposób:

git config core.excludesfile <gitignore file path>

Plik globalny .gitignore pomaga upewnić się, że usługa Git nie zatwierdza niektórych typów plików, takich jak skompilowane pliki binarne, w żadnym lokalnym repozytorium. Wzorce wyszukiwania plików w pliku specyficznym dla .gitignore repozytorium mają pierwszeństwo przed wzorcami w pliku globalnym .gitignore .

Użyj pliku z wykluczeniami

Można również dodawać wpisy wzorców wyszukiwania plików do exclude pliku w .git/info/ folderze lokalnego repozytorium. Plik exclude informuje usługę Git, które nieśledzone pliki mają być ignorowane. Używa tej samej składni dla wzorców wyszukiwania plików, co plik .gitignore.

Wpisy w exclude pliku mają zastosowanie tylko do nieśledzonych plików. Nie uniemożliwiają usłudze Git raportowania zmian w zatwierdzonych plikach, które już śledzą. Na repozytorium istnieje tylko jeden exclude plik.

Ponieważ usługa Git nie zatwierdza ani nie wypycha exclude pliku, możesz bezpiecznie użyć go do ignorowania plików w systemie lokalnym bez wpływu na nikogo innego.

Ignoruj zmiany za pomocą usługi git update-index

Czasami wygodne jest tymczasowe zatrzymanie śledzenia lokalnego pliku repozytorium i zignorowanie zmian w pliku przez usługę Git. Możesz na przykład dostosować plik ustawień dla środowiska deweloperskiego bez ryzyka popełnienia zmian. W tym celu możesz uruchomić polecenie git update-index z flagą skip-worktree.

git update-index --skip-worktree <file path>

Aby wznowić śledzenie, uruchom git update-index polecenie z flagą --no-skip-worktree .

Możesz również tymczasowo wyłączyć śledzenie pliku i sprawić, by Git ignorował zmiany w tym pliku, używając polecenia git update-index z flagą assume-unchanged. Ta opcja jest mniej skuteczna niż flaga skip-worktree , ponieważ operacja git pull , która zmienia zawartość pliku, może przywrócić flagę assume-unchanged .

git update-index --assume-unchanged <file path>

Aby wznowić śledzenie, uruchom git update-index polecenie z flagą --no-assume-unchanged .

Używanie narzędzia git rm do ignorowania zmian

Wpisy w .gitignore lub exclude nie mają wpływu na pliki, które już śledzi Git. Usługa Git śledzi pliki, które zostały wcześniej zatwierdzone. Aby trwale usunąć plik z migawki usługi Git, aby usługa Git nie śledziła go, ale bez usuwania go z systemu plików, uruchom następujące polecenia:

git rm --cached <file path>
git commit <some message>

Następnie użyj wpisu pliku .gitignore lub exclude, aby uniemożliwić Gitowi raportowanie zmian w pliku.

Następne kroki

Powiązane artykuły

• Konfigurowanie repozytorium Git
• Zapisz swoją pracę za pomocą commitów