Git Bisect: Finn committet som introduserte en feil
En funksjon fungerte i går, men feiler i dag. Lær hvordan du bruker Git bisect for å finne committet som introduserte en regresjon, teste revisjoner automatisk, og undersøke resultatet trygt.
Git Bisect: Finn committen som introduserte en feil
Et nettsted fungerte forrige uke. I dag er en checkout-beregning feil, en JavaScript-komponent svarer ikke lenger, eller en PHP-endepunkt returnerer uventede data.
Du vet at feilen dukket opp et sted i Git-historien, men repositoryet inneholder dozener eller hundre commits siden den siste fungerende versjonen. Å åpne hver commit og lese hver diff er sjelden den raskeste løsningen.
Git inkluderer et verktøy designet akkurat for denne situasjonen: git bisect. I stedet for å undersøke hver commit, bruker det en binær søk for å identifisere revisjonen som først introduserte problemet. Med en pålitelig test kan du automatisere undersøkelsen.
I denne opplæringen lager du et lite PHP-prosjekt, introduserer med vilje en regresjon, lokaliserer den med Git bisect, og lærer hvordan du bruker samme teknikk på sanne prosjekter.
1. Hvordan Git bisect fungerer
Forestill deg at applikasjonen fungerte i commit A, men feiler i commit H. Git bisect trenger to referansepunkter: en god commit, hvor funksjonen absolutt fungerte, og en dårlig commit, hvor feilen absolutt eksisterer.
Den sjekker ut en mellomliggende revisjon. Du tester den, rapporterer om den fungerer, og Git reduserer det gjenstående søkeområdet. For ca. 128 kandidat-commits, krever binær søk typisk rundt sju tester i stedet for å inspisere alle 128, forutsatt at atferden kan klassifiseres konsekvent.
Den offisielle Git-dokumentasjonen beskriver prosessen og dens begrensninger.
2. Lag en reproduserbar PHP-regresjon
Vi bygger en liten prisberegningsfunksjon. Ingen rammeverk, database, Composer-pakke eller webserver er nødvendig. Du trenger Git og PHP CLI installert, og Git må ha ditt forfatternavn og e-post konfigurert for committer.
Opprett en mappe og initialiser et repository:
mkdir git-bisect-demo
cd git-bisect-demo
git init
Opprett price.php:
<?php
declare(strict_types=1);
function finalPrice(int $price, int $discount): int
{
return $price - $discount;
}
Den forventede atferden er enkel: finalPrice(100, 20) returnerer 80.
Commit denne fungerende versjonen:
git add price.php
git commit -m "Add working price calculation"
Nå, lag en uavhengig endring:
echo "# Price Calculator" > README.md
git add README.md
git commit -m "Add project documentation"
Til slutt, introduser en feil ved å endre beregningen i price.php:
<?php
declare(strict_types=1);
function finalPrice(int $price, int $discount): int
{
return $price + $discount;
}
Commit den ødelagte versjonen:
git add price.php
git commit -m "Refactor price calculation"
Prosjektet har nå tre commits, med en bevisst regresjon i den siste.
3. Finn regresjonen manuelt
Start med å bekrefte at ditt arbeidstre er rent:
git status --short
Kommandoen skal produsere ingen utdata. Hvis du har ucommitet arbeid, commit det passende eller stash det før du starter.
Nå start Git bisect:
git bisect start
git bisect bad HEAD
git bisect good HEAD~2

Her er HEAD den ødelagte revisjonen, mens HEAD~2 peker til den første, fungerende committen. Git sjekker ut den mellomliggende commiten.
Test beregningen:
php -r 'require "price.php"; echo finalPrice(100, 20), PHP_EOL;'
Hvis utdataen er 80, marker revisjonen som god:
git bisect good
Hvis den er 120, marker den som dårlig:
git bisect bad
Git fortsetter med å velge commits til den identifiserer den første dårlige revisjonen. I denne tre-commit-demonstrasjonen trengs kun testing av én mellomliggende revisjon.
Når du er ferdig, gjenopprett din opprinnelige branch:
git bisect reset
Under bisect sjekker Git normalt ut historiske revisjoner i en detached HEAD-tilstand. git bisect reset returnerer deg til revisjonen du brukte før undersøkelsen.
4. Automatiser undersøkelsen med git bisect run
Manuell testing er nyttig når en feil krever visuell inspeksjon. Men hvis atferden kan sjekkes med en kommando, er automatisering mer effektiv.
Git støtter git bisect run <command>. Kommandoken kommuniserer resultatet sitt ved hjelp av en utgangskode:
| Utgangskode | Betydning |
|---|---|
0 |
God revisjon |
1–124 eller 126–127 |
Dårlig revisjon |
125 |
Kan ikke teste denne revisjonen |
| Andre verdier | Avbryt undersøkelsen |
Disse reglene kommer fra offisielt Git bisect-manual.
Opprett et testskript utenfor repositoryet, som ../check-price.php:
<?php
declare(strict_types=1);
require __DIR__ . '/git-bisect-demo/price.php';
exit(finalPrice(100, 20) === 80 ? 0 : 1);
Skriptet antar at prosjektmappen heter git-bisect-demo og ligger ved siden av check-price.php. Kjør disse kommandoene fra inne i prosjektmappen:
git bisect start HEAD HEAD~2
git bisect run php ../check-price.php
git bisect reset
Git kjører testen på utvalgte historiske revisjoner til den første dårlige committen er identifisert. Fordi testskriptet ligger utenfor repositoryet, fjerner ikke sjekking ut av en eldre revisjon det.
For sanne prosjekter, bruk en stabil testkommando eller et eksternt testskript som fungerer med de historiske revisjonene under undersøkelse.
5. Bruk teknikken på et sannt nettprosjekt
Samme arbeidsflyt fungerer for et WordPress-utvidelse, Joomla-utvidelse, JavaScript-applikasjon, eller PHP-bibliotek.
Anta at en checkout-funksjon er ødelagt i den nyeste versjonen, men den fungerte i utgave v1.4.0. Først verifiser at utgaven faktisk er god, så start:
git bisect start HEAD v1.4.0
Hvis prosjektet har en PHPUnit-test som fungerer på tvers av de utvalgte revisjonene, kan du kjøre den manuelt:
vendor/bin/phpunit tests/CheckoutTest.php
Etter hver test, rapporter git bisect good eller git bisect bad.
Når testen er pålitelig automatisert:
git bisect run vendor/bin/phpunit tests/CheckoutTest.php
git bisect reset
Historiske commits kan kreve ulike PHP-versjoner, avhengigheter, databaseskjemaer, eller byggverktøy. En test som feiler fordi miljøet er inkompatibelt, indikerer ikke nødvendigvis regresjonen. Sørg for at ditt testmiljø kan reprodusere de relevante historiske versjonene.

6. Hva om en gammel commit ikke kan testes?
Noen ganger feiler en historisk revisjon å bygge av en uavhengig grunn. Marker den ikke automatisk som dårlig.
Bruk:
git bisect skip
Git prøver en annen kandidat. For automatiserte tester, forteller utgangskode 125 Git å hoppe over revisjonen.
Å hoppe over for mange commits reduserer nøyaktigheten. Hvis en untestbar commit ligger ved siden av regresjonen, kan Git rapportere flere mulige skyldige i stedet for én eksakt commit.
En god langsiktig praksis er å vedlikeholde reproduserbare utviklingsmiljøer, låse avhengighetsversjoner, og holde kritiske regresjonstester uavhengige av urelatert infrastruktur.
7. Undersøk committen som introduserte feilen
Når Git identifiserer den første dårlige committen, undersøk den:
git show <commit-hash>
For å se hvilke filer som endret seg:
git show --stat <commit-hash>
For å inspisere en spesifikk fil:
git show <commit-hash> -- price.php
Den første dårlige committen er ikke nødvendigvis den eneste årsaken til feilen. En commit kan eksponere et tidligere skjult problem, interagere med en annen endring, eller avhenge av en ekstern tjeneste som har endret seg siden.
Bruk den identifiserte committen til å undersøke rotårsaken, ikke som automatisk bevis for at hver linje i den committen er feil.
8. Vanlige problemer og løsninger
Feilen dukker opp inkonsekvent
Hvis en test noen ganger passerer og noen ganger feiler på samme revisjon, blir bisect-resultatene upålitelige. Kjør testen flere ganger, fjern tidsavhengigheter der det er mulig, og kontroller eksterne input. Gjentatt testing øker tilliten, men øker undersøkelsestiden.
Testen feiler på alle historiske revisjoner
Bekreft at din kjente-gode commit virkelig er god. Sjekk ut den revisjonen separat og kjør testen før du starter en ny bisect-sesjon. Hvis den feiler der også, kan testen eller miljøet ditt være feil.
Git nekter å bytte revisjoner
Ucommitete endringer kan forhindre checkout. Sjekk git status og bevar endringene dine før du starter på nytt. Unngå destruktive kommandoer som git reset --hard med mindre du forstår nøyaktig hva de forkaster.
Historien inneholder mange merge-commits
For komplekse repositoryer, støtter Git:
git bisect start --first-parent HEAD v1.4.0
Dette følger first-parent-historien og kan hjelpe med å undersøke regresjoner introdusert gjennom merges. Det endrer hvilke commits som betraktes, så det er ikke en universell erstatning for en normal bisect.
Feilen avhenger av produksjonsdata
Kjør aldri historisk applikasjonskode mot en levende produksjonsdatabase. Bruk et isolert testmiljø med sanitisert testdata og et reproduserbart skjema. Eldre revisjoner kan inneholde migrasjoner eller antagelser som er inkompatible med produksjon.
9. En praktisk feilsøkingsjekkliste
- Bekreft at feilen er reproduserbar.
- Identifiser én revisjon som er kjent å fungere og én som er kjent å feile.
- Bevar ucommitet arbeid.
- Definer en pålitelig test med et klart pass/fail-resultat.
- Hold eksterne tjenester og testdata konsistente.
- Bruk
git bisect skipfor ærlig untestbare revisjoner. - Inspiser den identifiserte committen og verifiser rotårsaken.
- Avslutt med
git bisect reset.
Konklusjon
Git bisect omdanner en usikker feilsøkingsoppgave til en struktuert undersøkelse. I stedet for å gjette hvilken nylige endring som ødela en applikasjon, identifiserer du en fungerende revisjon, en ødelagt revisjon, og lar Git innsnekre historien.
Teknikken blir spesielt kraftig når den kombineres med automatiserte tester. En regresjon skjult blant hundre commits kan ofte lokaliseres med bare en håndfull sjekker.
For utviklere som vedlikeholder langvarige PHP-prosjekter, WordPress-utvidelser, Joomla-utvidelser, eller JavaScript-applikasjoner, er git bisect en av de mest nyttige Git-kommandoene utover hverdaglig branching og merging.