En fil med filtillägget GITIGNORE är en Git Ignore-fil som används med versions-/källkontrollsystemet Git.
Vad är en GITIGNORE-fil?
En Git Ignore-fil anger vilka filer och mappar som ska ignoreras i en given källkod.
Den kan användas per sökväg så att reglerna endast tillämpas på specifika mappar, men du kan också skapa en global GITIGNORE-fil som gäller för alla Git-förråd du har.
Du kan hitta dussintals exempel på GITIGNORE-filer som rekommenderas i olika scenarier, från GitHubs.gitignore-mallarsida.
Hur man öppnar en GITIGNORE-fil
GITIGNORE-filer är vanliga textfiler, vilket innebär att du kan öppna en med vilket program som helst som kan läsa textfiler.
Windows-användare kan öppna GITIGNORE-filer med det inbyggda Notepad-programmet eller med det kostnadsfria programmet Notepad++. För att öppna GITIGNORE-filer på macOS kan du använda Gedit. Linux-användare (liksom Windows och macOS) kanske tycker att Atom är användbart för att öppna och redigera GITIGNORE-filer.
Men GITIGNORE-filer är faktiskt inte användbara (dvs. de fungerar inte som en ignoreringsfil) om de inte används inom ramen för Git, som är fri programvara som körs på Windows, Linux och macOS.
Du kan använda GITIGNORE-filen genom att placera den där det är som du vill att reglerna ska gälla. Lägg en annan i varje arbetskatalog och ignoreringsreglerna kommer att fungera för varje mapp individuellt. Om du lägger GITIGNORE-filen i rotmappen i projektets arbetskatalog kan du lägga till alla regler där så att den tar en global roll.
Placera inte GITIGNORE-filen i Git-arkivet; som inte tillåter reglerna att gälla eftersom filen måste finnas i arbetskatalogen.
GITIGNORE-filer är användbara för att dela ignoreringsreglerna med någon annan som kan klona ditt arkiv. Det är därför, enligt GitHub, det är viktigt att lägga in det i ditt arkiv.
Hur man konverterar till/från en GITIGNORE-fil
Se denna Stack Overflow-tråd för information om att konvertera CVSIGNORE till GITIGNORE. Det enkla svaret är att det inte finns en vanlig filkonverterare som kan göra det åt dig, men det kan finnas ett skript som du kan använda för att kopiera över mönstren i CVSIGNORE-filen.
Se hur man konverterar SVN-förråd till Git-förråd för hjälp med det. Se även detta Bash-manus som kanske kan uppnå samma sak.
För att spara din GITIGNORE-fil i ett textfilformat, använd en av textredigerarna som nämns ovan. De flesta av dem kan konvertera till TXT, HTML och liknande oformaterad text.
Avancerad läsning av GITIGNORE-filer
Du kan bygga en lokal GITIGNORE-fil från Terminal, med detta kommando:
tryck på.gitignore
En global kan göras så här:
git config --global core.excludesfile ~/.gitignore_global
Alternativt, om du inte vill skapa en GITIGNORE-fil, kan du lägga till undantag i ditt lokala arkiv genom att redigera filen.git/info/exclude.
Här är ett enkelt exempel på en GITIGNORE-fil som skulle ignorera olika filer som genereras av operativsystemet:
. DS_Store
. DS_Store?
._. Trashes
ehthumbs.dbThumbs.db
Här är ett GITIGNORE-exempel som exkluderar LOG-, SQL- och SQLITE-filer från källkoden:
.log
.sql.sqlite
Det finns många mönsterregler som måste följas för att följa de rätta syntaxreglerna som Git kräver. Du kan läsa om dessa, och mycket mer om hur filen fungerar, från den officiella GITIGNORE Documentation-webbplatsen.
Se till att komma ihåg att om du redan har checkat in en fil för att inte ignoreras, och sedan lägger till en ignoreringsregel för den i GITIGNORE-filen, kommer Git inte att ignorera filen förrän du avspår den med följande kommando:
git rm --cachat filnamn
Öppnas din fil fortfarande inte?
Om din fil inte fungerar som beskrivits ovan, kontrollera att du läser filtillägget korrekt. Till exempel, om du inte kan öppna den med en textredigerare eller om Git inte känner igen filen, kanske du inte riktigt har att göra med en GITIGNORE-fil.
IGN är en annan ignoreringsfil men är i filformatet RoboHelp Ignore List skapat av och används med Adobe RoboHelp för att bygga Windows hjälpdokument. Även om filen kan ha en liknande funktion - att lista ord som ignoreras från sökningar i dokumentationen - kan den inte användas med Git och följer inte samma syntaxregler.
Om din fil inte öppnas, leta reda på dess filtillägg för att ta reda på vilket format den är i så att du kan hitta lämplig programvara som öppnar eller konverterar den.
FAQ
Hur ser jag vad som finns i min GITIGNORE?
Du kan öppna filen med din valda textredigerare. Du kan också använda kommandot git check-ignore sökvägskommando för att se om en viss fil finns på ignoreringslistan.
Vad är GITIGNORE och GITATTRIBUTES i Visual Studio?
GITIGNORE-filen listar objekt som inte spåras av ett Git-förråd, medan GITATTRIBUTES-filen anger hur man hanterar särskilda filer baserat på sökvägsnamnet. Du kan öppna och ändra båda filerna i Visual Studio från Repository Settings > Ignorera och attributfiler
Hur GITIGNORERA en mapp?
Om du vill ignorera innehållet i en viss katalog, öppna din GITIGNORE-fil och skriv folder_name /.
