Kuinka tarkastaa projektin historia Git Log -sovelluksella

Yksi Gitin tärkeimmistä palveluista on projektihistoria. Koska Git seuraa kaikkia arkistossa tehtyjä tiedostomuutoksia, se voi tarjota erittäin tehokkaita lokiominaisuuksia. Voit kysellä projektin historiaa monin eri tavoin ja voit purkaa ja näyttää erilaisia ​​tietoja yhdellä joustavalla komennolla.

git-loki komento on valtava, suurin kaikista tavallisista Git-komennoista. Sen käyttöohje on yli 2500 riviä pitkä. Onneksi, git-loki tarjoaa suurimman osan hyödyllisimmistä käytöksistään vain muutamalla avaintavalla.

Peruskirjaus oletuskäyttäytymisellä

Oletuksena, git-loki näyttää käänteisen kronologisen luettelon tekemisistä. Jokainen sitoutuminen sisältää sen tiivisteen, tekijän, päivämäärän ja sitoutumisviestin:

Komento käyttää hakulaitetta (esim. Vähemmän, enemmän) näyttämään koko tuotoksen, jotta voit helposti navigoida tuloksissa. Voit määrittää Gitin käyttämään valitsemaasi ohjelmaa, kuten kaikkein hakulaite.

Tässä on joitain git-lokilähtöjä git-lähdekoodin arkisto itse:

sitoutu 670b81a890388c60b7032a4f5b879f2ece8c4558 (HEAD -> master, origin / next,

instagram viewer


alkuperä / päällikkö, alkuperä / pää)
Kirjoittaja: Junio ​​C Hamano 
Päivämäärä: Ma 14.6. 13:23:28 2021 +0900
Toinen erä
Allekirjoittanut: Junio ​​C Hamano 

Tulos alkaa sitoutumis hashista (670...), jota seuraa luettelo haaroista, jotka osoittavat tällä hetkellä sitoutumista (PÄÄ -> päällikkö, jne.)

Seuraava rivi kuvaa tämän sitoumuksen tekijää ja antaa heidän nimensä ja sähköpostiosoitteensa.

Sitoumuksen täydellinen päivämäärä ja kellonaika seuraa seuraavalla rivillä.

Lopuksi, sitoutumisviestin koko sisältö tulee näkyviin. Voit hallita suurinta osaa kaikesta muusta, mitä git-loki tarjoaa, komentorivivalinnoilla. Vaihtoehtoja on kahta päätyyppiä:

• Muotoilu, joka määrittää, miten Git näyttää jokaisen sitoutumisen.
• Suodatus, joka määrittää, mikä sitoutuu git-loki sisältää.

Komentorivivaihtoehtojen lisäksi git-loki hyväksyy argumentit, jotka määrittävät tiedostot, komennot, haarat tai muun tyyppiset viitteet. Nämä soveltavat lisäsuodatusta.

Git-lokilähdön muotoilu

Yksi yksinkertaisimmista säätöistä on --yksi linja vaihtoehto, joka tuottaa hyvin lyhyen tuloksen:

git-loki - linja

Jokainen lokin rivi sisältää nyt vain lyhennetyn sitouttamis hashin ja aiheen sitoutumisviesti. Tämä on erinomainen tapa saada yleiskatsaus viimeaikaisiin sitoumuksiin projektissa:

Valitettavasti, ilman muuta asiayhteyttä, nämä tiedot eivät ole aina niin hyödyllisiä. Se saattaa antaa sinulle epämääräisen tunnelman projektista, mutta siinä ei ole päivämääriä ja muuta hyödyllistä tietoa tekijöistä ja tiedostoista.

Haarakaavion tarkasteleminen

--kaavio -vaihtoehdon avulla voit visualisoida haarojen välisiä suhteita. Se on hyvin yksinkertainen, mutta voi auttaa selvittämään monimutkaisen historian.

git-loki - linja - kaavio

Liittyvät: Kuinka luoda uusi haara Gitiin

Räätälöity melko tuotos

Voit saavuttaa monimutkaisemman muotoilun määrittämällä sen yksityiskohtaisesti käyttämällä --nätti vaihtoehto. Syntaksi siirtyy hyvin yksinkertaisesta paljon monimutkaisempaan, joten katso lisätietoja käyttöoppaasta.

git loki - melko = lyhyt

On pohjimmiltaan sama kuin git-loki ilman päivämäärää tai koko viesti:

git-loki - melko = oneline

Vastaa git-loki - linja.

git loki - melko = täydempi

Sisältää paljon yksityiskohtia. Se erottaa jopa kirjailijan ja tekijän, jotka voivat teoriassa olla erilaisia ​​ihmisiä:

Kanssa muoto: Vaihtoehto, voit toimittaa merkkijonon, joka sisältää haluamasi sisällön, mukaan lukien paikkamerkit, jotka on korvattu erilaisilla tiedoilla. Tässä on joitain esimerkkejä paikkamerkkeistä:

• % H tehdä hash
• % h lyhennetty sitoudu hash
• %ilmoitus kirjoittajan päivämäärä
• % ar tekijän päivämäärä, sukulainen
• % s sitouttaa viestin aihe
• % b sitouttaa viestin runko
• % s lyhennetyt vanhempien hajautukset

Voit lisätä kiinteät merkit tulosteeseen ja värittää sen. Tämä esimerkki näyttää myös muunnelman päivämäärämuodossa:

git-loki - melko = muoto: '% C (automaattinen)% h [% ad]% s' - päiväys = lyhyt

Huomaa, että suluissa on päivämäärä. Minkä tahansa muotoilun valitsetkin, jos haluat, että tulosteesta on hyötyä etenemisvaiheessa tai muussa tekstinkäsittelymuodossa, sinun tulisi miettiä, miten kunkin tuloksen osa rajataan.

Näytetään erot lokissa

Tärkeä yksityiskohta, kun tarkastellaan arkiston historiaa, ovat itse erot. Ne edustavat loppujen lopuksi sitä, mitä koodissa todella on muutettu! Ensinnäkin, voit saada yhteenvedon muutoksista jokaisen sitoutumisen rinnalla --shortstat:

git-loki - shortstat

Tämä lisää seuraavan rivin:

1 tiedosto muutettu, 48 lisäystä (+), 2 poistoa (-)

Jokaisen sitoutumisen loppuun. Näet usein tällaisen yhteenvedon - esimerkiksi koko GitHubin sivuilla - ja se on hyödyllinen tapa arvioida tietyn sitoutumisen laajuus. Jos haluat tarkempia tietoja, voit sisällyttää koko korjaustiedoston (erot) käyttämällä -p lippu:

git log -p

Suodattaa lokitulosteet

Riippumatta siitä, mitä muotoilua käytät, näet edelleen nykyisen haaran kaikkien lokien kaikki tiedot. Vaikka Git jakaa ne sivuiksi, se voi silti olla paljon tulosta. Seuraavien asetusten avulla voit mukauttaa lokin sisältämät sitoumukset.

Rajoittaminen määrällä

Jos haluat vain leikata tuloksia näyttämään viimeisimmät muutokset, käytä -[määrä] syntaksi:

git-loki -2

Rajoittaminen päivämäärän mukaan

Voit rajoittaa sitoumusjoukon tietylle ajanjaksolle käyttämällä --siitä asti kun (--jälkeen) ja --siihen asti kun (--ennen) vaihtoehtoja. Kukin ottaa päivämäärän ISO 8601 -muodossa. Voit käyttää kumpaakin --siitä asti kun tai --siihen asti kun yksinään tai molemmat yhdessä määritelläksesi alueen. Vaihtoehdot --jälkeen ja --ennen ovat synonyymejä.

git loki --since = "2021-01-01" - asti = "2021-05-01"

Rajoittaminen tiedostolla

Git-loki voi keskittyä tiettyyn tiedostoon eikä kaikkiin arkiston tiedostoihin. Tämä auttaa sinua selvittämään, kuinka tietty tiedosto on muuttunut ajan myötä. Liitä tiedostonimi yksinkertaisesti git-komentosi loppuun:

git-lokin tiedostonimi

Näet vain ne muutokset, joihin se vaikuttaa Tiedoston nimi.

Eri sivukonttoreiden välillä

Sinulla voi olla joitain ainutlaatuisia vaatimuksia haaran lokia tarkasteltaessa. Esimerkiksi koko historian sijaan haluat ehkä vain nähdä, mitä kyseisessä haarassa on tapahtunut. Git-loki voi auttaa viite1..viite2 syntaksi. Voit käyttää kolmea hieman erilaista lähestymistapaa:

1. Näytä sitoumukset, jotka ovat pääasiassa, mutta eivät haaraa:

   git-loki - linjan alkuperä / haara.. alkuperä / pää

2. Tarkastele sivuliikkeessä olevia, mutta ei päätoimintoja:

   git-loki - linjan alkuperä /tärkein..alku /haara

3. Näytä sitoumukset, jotka ovat olemassa vain haarassa tai pääosassa:

   git-loki - linjan alkuperä / haara...alkuperä / pää

Aivan kuten voit tarkastella haarojen välistä historiaa viite1..viite2 syntaksi, voit myös tarkastella tagien välistä historiaa samalla tavalla. Loppujen lopuksi sekä tunnisteet että haarat ovat viittaustyyppejä.

git-loki --abbrev-sitoutua - melko = muotoilu: '% h% ar% s' v2.32.0-rc3..v2.32.0

Jos valmistelet julkaisutiedot suuremmalle projektille, git shortlog pitäisi olla ensimmäinen käyntisatama. Se tuottaa luettelon tekijöistä, joiden rinnalla on sitoutuneita aiheita. Voit siirtää sille viitealueen rajoittaa historiaa samalla tavalla kuin git-loki:

git shortlog v2.32.0-rc3..v2.32.0

git show -komento on jopa monipuolisempi kuin git-loki. Se voi toimia tunnisteiden ja muun tyyppisten git-objektien kanssa historiatietojen ulkopuolella. Se jakaa monia vaihtoehtoja git-loki, mutta tarvitset sitä todella vain, jos haluat syventää alemman tason yksityiskohtia.

Tarkista menneisyys Git-lokilla

Git-loki on monimutkainen komento, mutta voit saada paljon käyttöä sen perusasetuksista. Arkiston historian selaaminen on erinomainen tapa ymmärtää, kuinka usein muutoksia tapahtuu ja kuinka moni ihminen tekee ne. Kun olet ymmärtänyt projektin historian hyvin, sinulla on hyvät mahdollisuudet osallistua siihen itse.

Liity sosiaalisen koodauksen trendiin ja edistä GitHub-arkistoja

Haluatko käyttää koodauslihaksiasi ja auttaa avoimen lähdekoodin projekteja? Näin voit osallistua GitHubiin.

Lue seuraava

Kirjailijasta