Gjennomgå og slå sammen en PR

Denne guiden viser deg hvordan du gjennomgår og slår sammen en pull request.

Åpne PR-arbeidsflaten

Gå til Pull requests i sidestolpen
Velg en PR fra listen

En PR åpnes som en arbeidsflate med faner, ikke som en enkelt side. Fem faner er åpne som standard, i denne rekkefølgen: Oversikt, Diff, Kildekontroll, Chat og Handlinger (CI-sjekker gruppert etter arbeidsflyt). Gjennomgang — fremdriften til gjennomgangspipelinen, deretter artefakten den publiserte med funnlisten sin — er bevisst ikke blant dem: en PR har ingen gjennomgang før noen ber om en, så Spør AI åpner den. En terminal, en redigerer for enkeltfiler, en innebygd code-server og en nettleser i appen åpnes ved behov; faner for forhåndsvisning av distribusjon settes inn automatisk når en forhåndsvisnings-URL oppdages på PR-en. Fanoppsettet ditt huskes per PR.

Fanen Oversikt har PR-ens metadata (forfatter, gren, etiketter, tildelte, reaksjoner, commits, sjekkstatus) og handlingsraden: oppdater, Gjennomgang, Slå sammen, åpne i IDE og en overflytsmeny ⋯.

Les diffen

Åpne Diff-fanen for å se hele PR-diffen på én gang, med filtreet for å hoppe mellom filer.

Innstillingsknappen i diff-verktøylinjen veksler mellom Delt (side ved side) og Samlet visning og slår linjebryting og ligaturer i kodefonten av og på.
Hunk-overskriftene @@ er erstattet av Show N lines / Show end of file, som fletter inn den omkringliggende konteksten når du klikker.
Trykk j / k for å gå mellom filer, c for å klappe sammen eller utvide filen som har fokus, t for å sette sidepanelet tilbake til filtreet, og ⌘F for å søke i hele diffen (Enter / Shift+Enter går gjennom treffene).
Trykk v for å merke filen som har fokus som sett, og markøren går videre til neste fil. På GitHub lagres tilstanden «sett» hos forgen, så den følger deg mellom klienter; GitLab og Bitbucket har ingen slik API, så der huskes den bare på denne enheten.

Når du drar med musen i kodeområdet, markerer du tekst ned til nøyaktig riktig kolonne, og ⌘C kopierer rå kildekode i stedet for de tegnede diff-markørene.

Legg igjen kommentarer i linjen

Trykk på renden av en kodelinje for å åpne et kommentarfelt forankret til den linjen, eller bruk +-knappen i en filoverskrift for en kommentar på filnivå
Skriv tilbakemeldingen din i Markdown
Send inn

På GitHub og GitLab tilbyr kommentarfeltet to måter å sende inn på: Legg til enkeltkommentar publiserer med en gang, og Start en gjennomgang / Legg til i gjennomgang setter kommentaren i kø til en ventende gjennomgang som sendes ut med Godkjenn, Be om endringer eller Kommentar. Bitbucket har ingen samling av ventende gjennomganger, så der publiseres hver innsending med en gang. En umiddelbar publisering viser en ventende tilstand til forgen bekrefter den, og går så over til synkronisert. Hvis publiseringen mislykkes, merkes tråden med feilen og tilbyr et nytt forsøk.

Bare selve teksten i gjennomgangen er et utkast: den lagres på serversiden mot (eier, repo, PR-nummer) et øyeblikk etter at du slutter å skrive, så den overlever en omlasting og følger deg mellom skrivebords- og nettklienten.

Send inn en gjennomgang

Trykk Gjennomgang i handlingsraden i Oversikt (den er skjult på dine egne PR-er og på en lukket eller sammenslått PR)
Skriv gjennomgangsteksten. Du kan legge ved et bilde, sette inn et emoji eller en GIF og veksle mellom skriv og forhåndsvisning
Trykk Be om endringer, Kommentar eller Godkjenn

Vedtaket er knappen — det finnes ingen egen vedtaksvelger. Etter Godkjenn eller Be om endringer bytter knappen etikett til Godkjent eller Ba om endringer, og utkastteksten tømmes. Et Kommentar-vedtak lar knappen stå med etiketten Gjennomgang.

Slå sammen

Knappen Slå sammen vises når du har skrivetilgang, og PR-en er åpen og ikke et utkast. Fargen er et signal om hvor klar PR-en er, utledet fra påkrevde godkjenninger og sjekkstatus (klar / venter / blokkert) — det er bare veiledende. Knappen deaktiveres aldri av gjennomgangsstatus; det er forgenens egen grenbeskyttelse som håndhever reglene.

Trykk Slå sammen for å åpne sammenslåingspanelet
Velg en flettemetode: squash, merge-commit eller rebase (squash er standard). Bitbucket har ingen ekte rebase-sammenslåing, så rebase tilordnes fast-forward-strategien deres og mislykkes på en divergert gren
For squash og merge-commit redigerer du den forhåndsutfylte commit-tittelen og commit-beskrivelsen. Rebase tar ingen av dem og skjuler begge feltene
Les varselpanelet — det navngir mislykkede sjekker og ventende gjennomganger, men blokkerer deg ikke
Trykk sammenslåingsknappen i panelet for å bekrefte

Sammenslåing kan ikke angres: den dytter commits til forgen, så den får et bekreftelsessteg i stedet for en angreoppføring. Etterpå ugyldiggjøres cachen til PR-en, statusen går over til Sammenslått, og en PullRequestStatusChanged-hendelse utløses med status merged. Den hendelsen frigjør det kortvarige worktreet for «åpne i redigerer» og starter to forhåndsdefinerte pipelines: Stale repository cleanup, som fjerner PR-ens foreldede worktreer og samtalemapper, og Release notes, som utarbeider et changelog-innlegg.

Gi PR-en til reviewer-agenter

Overflytsmenyen ⋯ på fanen Oversikt har Spør AI, som starter den forhåndsdefinerte pr_review-pipelinen for denne PR-en. Elementet vises bare mens PR-en er åpen. Se Bruk AI-drevet gjennomgang for hva pipelinen gjør og hvordan du publiserer funnene, og Gjennomgangsberegning for den deterministiske modellen med kohorter og akser.

Gjennomgå en ekstern PR

Control Center importerer også PR-er som mennesker utenfor appen har åpnet. Gjennomgangsflyten ovenfor er identisk. Eksterne PR-er oppdages av PR-pollingtjenesten.