Granska och slå ihop en PR

Den här guiden visar hur du granskar och slår ihop en pull request.

Öppna PR-arbetsytan

Gå till Pull requests i sidofältet
Välj en PR i listan

En PR öppnas som en flikbaserad arbetsyta, inte som en enskild sida. Fem flikar öppnas som standard, i den här ordningen: Översikt, Diff, Källkontroll, Chatt och Åtgärder (CI-kontroller grupperade efter arbetsflöde). Granskning – granskningspipelineens förlopp, och därefter artefakten den publicerade med sin fyndlista – är medvetet inte en av dem: en PR har ingen granskning förrän någon ber om en, så Fråga AI öppnar den. En terminal, en redigerare för en fil i taget, en inbäddad code-server och en webbläsare i appen öppnas vid behov; flikar för driftsättningsförhandsvisning läggs in automatiskt när en förhandsvisnings-URL upptäcks på PR:en. Din fliklayout sparas per PR.

Fliken Översikt innehåller PR:ens metadata (författare, gren, etiketter, tilldelade, reaktioner, commits, kontrollstatus) och åtgärdsraden: uppdatera, Granskning, Slå samman, öppna i IDE och en överflödesmeny ⋯.

Läs diffen

Öppna fliken Diff för att se hela PR-diffen på en gång, med ett filträd för att hoppa mellan filer.

Inställningsknappen i diffens verktygsfält växlar mellan delad (sida vid sida) och enhetlig vy och slår på eller av radbrytning och ligaturer för kodtypsnittet.
@@-huvuden för hunkar ersätts av de interaktiva elementen Show N lines / Show end of file, som fogar in den omgivande kontexten vid klick.
Tryck på j / k för att stega mellan filer, c för att fälla ihop eller expandera den fokuserade filen, t för att återställa sidofältet till filträdet och ⌘F för att söka i hela diffen (Enter / Shift+Enter går igenom träffarna).
Tryck på v för att markera den fokuserade filen som visad, och markören går vidare till nästa fil. På GitHub lagras ”visad”-statusen hos kodvärden, så den följer med dig mellan klienter; GitLab och Bitbucket har inget sådant API, så där kom den bara ihåg på den här enheten.

Musdrag i kodområdet markerar text ned till exakt kolumn, och ⌘C kopierar rå källkod i stället för de renderade diffmarkörerna.

Lämna kommentarer inline

Tryck i rännan på en kodrad för att öppna ett kommentarsfält förankrat vid den raden, eller använd +-knappen på en filrubrik för en kommentar på filnivå
Skriv din återkoppling i Markdown
Skicka in

På GitHub och GitLab erbjuder kommentarsfältet två sätt att skicka in: Lägg till en kommentar publiceras direkt, och Starta en granskning / Lägg till i granskning lägger kommentaren i kö till en väntande granskning som skickas med Godkänn, Begär ändringar eller Kommentar. Bitbucket har ingen batchning av väntande granskningar, så där publiceras varje inskickning direkt. En omedelbar publicering visar ett väntande tillstånd tills kodvärden bekräftar den, och växlar sedan till synkroniserad. Om publiceringen misslyckas markeras tråden med felet och erbjuder ett nytt försök.

Endast granskningens text är ett utkast: den sparas på serversidan mot (ägare, repo, PR-nummer) en stund efter att du slutat skriva, så den överlever en omladdning och följer med dig mellan skrivbords- och webbklienten.

Skicka in en granskning

Tryck på Granskning i åtgärdsraden på fliken Översikt (den döljs på dina egna PR:er och på en stängd eller sammanslagen PR)
Skriv granskningens text. Du kan bifoga en bild, infoga en emoji eller en GIF och växla mellan skrivläge och förhandsvisning
Tryck på Begär ändringar, Kommentar eller Godkänn

Utfallet är knappen – det finns ingen separat väljare för utfallet. Efter Godkänn eller Begär ändringar märker knappen om sig till Godkänd eller Ändringar begärda och utkastets text rensas. Ett Kommentar-utfall lämnar knappen märkt Granskning.

Slå ihop

Knappen Slå samman visas när du har skrivbehörighet och PR:en är öppen och inte ett utkast. Dess färg är en beredskapssignal som härleds från obligatoriska godkännanden och kontrollstatus (redo / väntande / blockerad) – den är endast vägledande. Knappen inaktiveras aldrig av granskningsstatus; det är kodvärdens eget grenskydd som upprätthåller reglerna.

Tryck på Slå samman för att öppna utfällningspanelen för sammanslagning
Välj en sammanfogningsmetod: squash, merge-commit eller rebase (squash är standard). Bitbucket har ingen riktig rebase-sammanslagning, så rebase mappas till dess fast-forward-strategi och misslyckas på en divergerad gren
För squash och merge-commit redigerar du den förifyllda commit-titeln och commit-beskrivningen. Rebase tar ingendera och döljer båda fälten
Läs varningspanelen – den namnger misslyckade kontroller och väntande granskningar, men blockerar dig inte
Tryck på sammanfogningsknappen i panelen för att bekräfta

Sammanslagning går inte att ångra: den skickar commits till kodvärden, så den får ett bekräftelsesteg i stället för en ångra-post. Efteråt ogiltigförklaras PR:ens cache, dess status växlar till Sammanslagen och en PullRequestStatusChanged-händelse utlöses med statusen merged. Den händelsen frigör den efemära worktreen för ”öppna i redigeraren” och startar två medföljande pipelines: Stale repository cleanup, som tar bort PR:ens inaktuella worktrees och samtalsmappar, och Release notes, som utarbetar en post i ändringsloggen.

Lämna över PR:en till granskaragenter

Överflödesmenyn ⋯ på fliken Översikt innehåller Fråga AI, som startar den medföljande pr_review-pipelinen för den här PR:en. Den visas bara medan PR:en är öppen. Se Använd AI-driven granskning för vad pipelinen gör och hur du publicerar dess fynd, och Granskningsberäkning för den deterministiska kohort- och axelmodellen.

Granska en extern PR

Control Center importerar även PR:er som människor öppnar utanför appen. Granskningsflödet ovan är identiskt. Externa PR:er upptäcks av PR-pollningstjänsten.