git-check-ignore(1)
git-check-ignore(1)
NAMN
git-check-ignore – felsök gitignore- och exclude-filer
SYNOPSIS
git check-ignore [<flaggor>] <sökväg>... git check-ignore [<flaggor>] --stdin
BESKRIVNING
För varje sökväg som anges på kommandoraden, eller läses från en fil via --stdin, kontrollerar git check-ignore om filen utesluts av .gitignore eller av andra indatafiler som används av Gits exclude-mekanism. Om sökvägen utesluts skrivs den ut.
Som standard visas inte spårade filer alls, eftersom de inte omfattas av exclude-regler. Se dock flaggan --no-index.
FLAGGOR
-q, --quiet
Skriv inte ut något. Sätt endast avslutsstatus. Detta är endast giltigt med en enda sökväg.
-v, --verbose
I stället för att skriva ut de sökvägar som utesluts skrivs, för varje sökväg som matchar ett exclude-mönster, även exclude-mönstret ut tillsammans med sökvägen. Att en sökväg matchar ett exclude-mönster betyder normalt att den utesluts, men om mönstret börjar med ! är det ett negerat mönster och en matchning betyder då att sökvägen inte utesluts.
För prioritetsregler inom och mellan exclude-källor, se gitignore(5).
--stdin
Läs sökvägar från standard in, en per rad, i stället för från kommandoraden.
-z
Utdataformatet ändras så att det blir lättare att tolka maskinellt; se avsnittet UTDATA nedan. Om --stdin också anges separeras inmatade sökvägar med NUL-tecken i stället för radmatning.
-n, --non-matching
Visa även angivna sökvägar som inte matchar något mönster. Detta är endast meningsfullt när --verbose är aktiverat, eftersom det annars inte går att skilja mellan sökvägar som matchar ett mönster och sökvägar som inte gör det.
--no-index
Titta inte i indexet när kontrollerna görs. Detta kan användas för att felsöka varför en sökväg blev spårad, till exempel med git add, och inte ignorerades av reglerna som användaren förväntade sig. Det kan också användas vid utveckling av mönster, inklusive negationer, för att matcha en sökväg som tidigare lagts till med git add -f.
UTDATA
Som standard skrivs alla angivna sökvägar som matchar ett ignore-mönster ut, en per rad. Om inget mönster matchar en viss sökväg skrivs ingenting ut för den sökvägen. Det betyder att sökvägen inte ignoreras.
Om --verbose anges består utdata av rader på formen:
<källa> <KOLON> <radnummer> <KOLON> <mönster> <HT> <sökväg>
<sökväg> är sökvägen till den fil som undersöks. <mönster> är det matchande mönstret. <källa> är filen där mönstret kommer från, och <radnummer> är mönstrets radnummer i den källan. Om mönstret innehöll prefixet ! eller suffixet / bevaras detta i utdata. <källa> är en absolut sökväg när den hänvisar till filen som konfigurerats med core.excludesFile, eller relativ till arkivets rot när den hänvisar till .git/info/exclude eller en exclude-fil per katalog.
Om -z anges avgränsas sökvägarna i utdata med nulltecken. Om --verbose också anges används nulltecken även i stället för kolon och hårda tabbar:
<källa> <NULL> <radnummer> <NULL> <mönster> <NULL> <sökväg> <NULL>
Om -n eller --non-matching anges skrivs även sökvägar som inte matchar ut. I så fall är alla fält i varje utdatapost tomma utom <sökväg>. Detta kan vara användbart vid icke-interaktiv körning, så att filer stegvis kan strömmas till STDIN i en långlivad check-ignore-process, och STDOUT för varje fil anger om filen matchade ett mönster eller inte. Utan denna flagga vore det omöjligt att veta om avsaknad av utdata för en viss fil betyder att den inte matchade något mönster, eller att utdata ännu inte har genererats.
Buffring sker enligt dokumentationen för flaggan GIT_FLUSH i git(1). Anroparen ansvarar för att undvika dödlägen som orsakas av att en inmatningsbuffert fylls för mycket eller att läsning sker från en tom utdatabuffert.
AVSLUTSSTATUS
0
En eller flera av de angivna sökvägarna ignoreras.
1
Ingen av de angivna sökvägarna ignoreras.
128
Ett fatalt fel inträffade.
SE ÄVEN
gitignore(5), git-config(1), git-ls-files(1)
GIT
Del av git(1)-sviten.
COLOPHON
Denna sida är en del av projektet git (Git distributed version control system). Information om projektet finns på http://git-scm.com/. Om du har en felrapport för denna manualsida, se http://git-scm.com/community.
Denna sida hämtades från projektets uppströms Git-arkiv på https://github.com/git/git.git den 2026-05-24. Vid den tidpunkten var datumet för den senaste commit som hittades i arkivet 2026-05-22.
Om du upptäcker renderingsproblem i HTML-versionen av sidan, tror att det finns en bättre eller mer uppdaterad källa för sidan, eller har rättelser eller förbättringar av informationen i detta COLOPHON-avsnitt, skicka e-post till man-pages@man7.org.
Git 2.54.0.254.g6a4418 2026-05-22 GIT-CHECK-IGNORE(1)