Tiedostojen ja hakemistojen ohittaminen gitissä (.gitignore)

Usein, kun työskentelet Git-ohjelmaa käyttävässä projektissa, sinun kannattaa sulkea pois tiettyjen tiedostojen tai hakemistojen siirtäminen etävarastoon.

.gitignore tiedosto määrittelee mitä seuraamattomia tiedostoja Gitin tulisi jättää huomioimatta.

Mitä tiedostoja tulisi jättää huomioimatta?

Ohitetut tiedostot ovat yleensä alustakohtaisia ​​tiedostoja tai automaattisesti luomia tiedostoja rakennusjärjestelmistä. Joitakin yleisiä esimerkkejä ovat:

• Runtime-tiedostot, kuten loki-, lukitus-, välimuisti- tai väliaikaiset tiedostot.Failit, joissa on arkaluontoisia tietoja, kuten salasanoja tai API-avaimia.Kompoloidut koodit, kuten .class tai .o .Dependency hakemistot, kuten /vendor tai /node_modules .Build-hakemistot, kuten /public , /out tai /dist .Systeemitiedostot, kuten .DS_Store tai Thumbs.db IDE, tai tekstieditorin asetustiedostot.

.gitignore

Paikallinen .gitignore tiedosto sijoitetaan yleensä arkiston juurikansioon. Voit kuitenkin luoda useita .gitignore tiedostoja arkiston eri alihakemistoihin. .gitignore tiedostojen mallit vastaavat sitä hakemistoa, jossa tiedosto sijaitsee.

Alemman tason hakemistoissa (alihakemistoissa) olevissa tiedostoissa määritetyt mallit ovat etusijalla ylemmän tason hakemistoihin nähden.

Paikalliset .gitignore tiedostot jaetaan muiden kehittäjien kanssa, ja niiden tulisi sisältää malleja, jotka ovat hyödyllisiä kaikille muille arkiston käyttäjille.

Henkilökohtaiset Ohita säännöt

Paikalliselle arkistolle ominaiset mallit, joita ei pitäisi jakaa muille arkistoille, tulee asettaa .git/info/exclude tiedostoon.

Voit esimerkiksi käyttää tätä tiedostoa ohittaaksesi henkilökohtaisten projektityökalujen luomat tiedostot.

Globaali

Git antaa sinun myös luoda globaalin .gitignore tiedoston, jossa voit määrittää .gitignore säännöt jokaiselle paikallisen järjestelmän Git-arkistolle.

Tiedosto voidaan nimetä mitä haluat ja tallentaa mihin tahansa sijaintiin. Yleisin paikka tämän tiedoston pitämiseen on kotihakemisto. Sinun on luotava tiedosto manuaalisesti ja määritettävä Git käyttämään sitä.

Jos esimerkiksi haluat asettaa ~/.gitignore_global globaaliksi Git- ~/.gitignore_global , toimisi seuraavasti:

1. Luo tiedosto:

   touch ~/.gitignore_global

   Lisää tiedosto Git-kokoonpanoon:

   git config --global core.excludesfile ~/.gitignore_global

   Avaa tiedosto tekstieditorilla ja lisää säännöt siihen.

Globaalit säännöt ovat erityisen hyödyllisiä, kun jätetään huomioimatta tietyt tiedostot, joita et koskaan halua sitoutua, kuten tiedostot, joissa on arkaluontoisia tietoja tai käännetyt suoritettavat tiedostot.

Aiemmin toimitettujen tiedostojen ohittaminen

Työkopiosi tiedostoja voidaan joko seurata tai seurata.

Jos haluat jättää huomioimatta aiemmin sitoutuneen tiedoston, sinun on purettava tiedosto ja poistettava hakemisto ja lisättävä sitten tiedosto tiedostoon .gitignore :

git rm --cached filename

- --cached -vaihtoehto käskee git: ää poistamaan tiedostoa työskentelevästä puusta, mutta vain poistamaan sen hakemistosta.

Poista hakemisto rekursiivisesti käyttämällä -r vaihtoehtoa:

git rm --cached filename

Kun poistat tiedostoja rekursiivisesti, käytä -n asetusta, joka suorittaa ”kuiva-ajon” ja näyttää mitä poistettavat tiedostot:

git rm -r -n directory

.gitignore tiedoston virheenkorjaus

Joskus voi olla haastavaa päättää, miksi tiettyä tiedostoa ei oteta huomioon, varsinkin kun käytät useita .gitignore tiedostoja tai monimutkaisia ​​malleja. Tässä on kätevä git check-ignore -komento -v vaihtoehdolla, joka käskee git näyttää yksityiskohdat vastaavasta kuviosta.

Voit esimerkiksi tarkistaa, miksi www/yarn.lock tiedostoa ei oteta huomioon:

git check-ignore -v www/yarn.lock

gitignore näyttää polun gitignore tiedostoon, vastaavan rivin numero ja todellinen kuvio.

www/.gitignore:31:/yarn.lock www/yarn.lock

Komento hyväksyy myös useamman kuin yhden tiedostonimen argumentteina, ja tiedoston ei tarvitse olla työpuussa.

Kaikkien ohitettujen tiedostojen näyttäminen

git status -komento, jossa on --ignored näyttää luettelon kaikista ohitettavista tiedostoista:

git status --ignored

johtopäätös

.gitignore tiedoston avulla voit sulkea pois tiedostojen tarkistamisen arkistosta. Tiedosto sisältää globaalit kuviot, jotka kuvaavat mitä tiedostoja ja hakemistoja tulee jättää huomioimatta.

gitignore.io on online-palvelu, jonka avulla voit luoda .gitignore tiedostoja käyttöjärjestelmällesi, ohjelmointikielellesi tai IDE: lle.