Commit ja Push

Lisää tiedostot stage-alueelle, kirjoita commit-viesti käsin tai AI-agentin avulla ja pushaa etärepositorioon muutamalla klikkauksella.

Kun olet käynyt diffin läpi ja olet tyytyväinen AI-agentin tekemiin muutoksiin, on aika tehdä commit ja push. Tämä opas käy läpi koko työnkulun stagingista pushaamiseen etärepositorioosi.

Muutosten stage-aminen

Stagingin avulla voit valita tarkasti, mitkä muutokset kuuluvat tähän committiin. Voit esimerkiksi haluta commitoida ominaisuuskoodin erikseen konfiguraatiomuutoksesta.

Git-paneelissa jokainen muokattu tiedosto näkyy Unstaged Changes -osiossa:

  • Valitse tiedoston vieressä oleva valintaruutu, jos haluat lisätä sen stage-alueelle yksittäin
  • Napsauta Stage All, jos haluat lisätä kaikki muuttuneet tiedostot kerralla
  • Voit poistaa tiedoston stage-alueelta poistamalla valinnan — se siirtyy takaisin Unstaged-osioon

Stage-alueelle lisätyt tiedostot siirtyvät sivupalkin yläreunassa olevaan Staged Changes -osioon. Committiin sisältyvät vain stage-alueelle lisätyt tiedostot.

Voit myös lisätä stage-alueelle yksittäisiä hunkkeja (tiedoston osioita) koko tiedoston sijaan. Vie diff-näkymässä hiiri hunkin päälle ja napsauta näkyviin tulevaa +-painiketta, jolloin vain kyseinen osio lisätään stage-alueelle. Tästä on hyötyä, kun tiedostossa on kaksi toisiinsa liittymätöntä muutosta ja haluat commitoida nyt vain toisen.

Muutosten katselu kansiopuuna

Agentit tuottavat leveitä ja matalia diffejä — muutos, joka koskee neljää hakemistoa ja kahdeksaatoista tiedostoa, on aivan tavallinen. Tasainen lista muuttaa sen kahdeksaksitoista lähes identtisten polkujen riviksi.

Filter-kentän vieressä oleva kytkin vaihtaa Changes-listan tasaisen listan ja VS Code -tyylisen kansiopuun välillä, ja valintasi säilyy, kun avaat dialogin seuraavan kerran.

Git Changes -dialogi kansiopuutilassa: 18 muuttunutta tiedostoa sijoitettuna kansioiden scripts, src/main/database/adapters ja renderer/components alle, ja jokaisella hakemisriviltä löytyy kansiokohtainen staging-valintaruutu

  • Kansion valintaruutu lisää stage-alueelle tai poistaa sieltä kaiken sen alla olevan yhdellä napsautuksella, joten alueittain tarkastelu ja alueittain stage-aminen ovat sama ele.
  • Kansion kohdalla oleva viiva tarkoittaa, että se on osittain stage-alueella. Osittaisen stagingin voi luoda helposti vahingossa, ja tasaisessa listassa se on lähes näkymätön; kolmitilainen valintaruutu tuo sen esiin hakemistotasolla.
  • Collapse all / expand all helpottavat työskentelyä, kun muutosjoukko ulottuu useisiin hakemistoihin.

Tasainen lista on ennallaan ja näyttää edelleen koko polun jokaisella rivillä, kun muutosjoukko on niin pieni, että ryhmittely on vain ylimääräinen napsautus.

Commit-viestin kirjoittaminen

Kun tiedostot on lisätty stage-alueelle, kirjoita commit-viestisi Git-paneelin alareunan tekstikenttään.

Hyvä commit-viesti tekee historiastasi luettavan — sekä tulevalle itsellesi että kaikille muille projektin parissa työskenteleville. Muutama vinkki:

  • Käytä käskymuotoa — kirjoita "Add login form", ei "Added login form" eikä "Adding login form"
  • Kuvaa, mitä muuttui ja miksi — "Fix null check in user.ts" on hyödyllisempi kuin "fix bug"
  • Pidä ensimmäinen rivi alle 72 merkin pituisena — useimmat git-työkalut typistävät pidemmät viestit listanäkymissä
  • Lisää tarvittaessa runko — paina Enter kahdesti ensimmäisen rivin jälkeen, jos haluat lisätä pidemmän selityksen sen alle

Esimerkkejä selkeistä commit-viesteistä:

  • Add email validation to signup form
  • Fix crash when user list is empty
  • Update API base URL for production

Anna agentin kirjoittaa se

Commit-yhteenvedon kipinäpainike antaa diffisi asennetulle AI CLI:lle ja pyytää siltä viestiä.

  • Voit kiinnittää, mikä agentti viestin kirjoittaa, tai antaa 1DevToolin käyttää ensimmäistä asennettua. Kimi Code on listalla muiden agenttien rinnalla. Kun agentteja on asennettu paljon, valikko mukautuu ikkunan kokoon ja siinä voi vierittää.
  • Valitse tyyli: Conventional, Plain tai Gitmoji.
  • Jos mitään ei ole vielä lisätty stage-alueelle, se käyttää työpuun diffiä — voit siis saada viestin ennen kuin päätät, mitä lisäät stage-alueelle.

Tulos ilmestyy viestikenttään tavallisena muokattavana tekstinä. Se on luonnos, ei commit.

Commit

Napsauta viestikentän alla olevaa Commit-painiketta. Stage-alueelle lisätyt muutokset tallennetaan paikalliseen git-historiaasi uutena committina, ja staged-tiedostojen osio tyhjenee.

Commit näkyy nyt haarasi historiassa. Jos haluat kumota sen, napsauta committia hiiren oikealla painikkeella historianäkymässä ja valitse Undo Commit — tämä palauttaa muutokset unstaged-tiedostoihisi ilman, että mitään menetetään.

Push etärepositorioon

Commit tallentaa muutokset paikallisesti. Voit lähettää ne GitHubiin, GitLabiin tai muuhun etärepositorioosi seuraavasti:

  1. Napsauta Git-paneelin työkalupalkin Push-painiketta (ylänuolikuvake)
  2. Jos haara on jo olemassa etärepositoriossa, commitit pushataan heti
  3. Jos kyseessä on uusi haara, jota ei ole vielä etärepositoriossa, napsauta Publish Branch — tämä luo haaran etärepositorioon ja pushaa commitit

Jos sinulta pyydetään tunnistetietoja, voit syöttää ne tai vaihtaa SSH-avaintunnistautumiseen. Katso Git-tilit, miten yhdistät GitHub-tilisi, jolloin tunnistetiedot hoidetaan automaattisesti.

Uuden haaran pushaaminen Gitissä

Muutosten pullaaminen

Voit hakea muutokset etärepositoriosta (esimerkiksi jos tiimikaveri on pushannut jotain) seuraavasti:

  1. Napsauta työkalupalkin Pull-painiketta (alanuolikuvake)
  2. Etämuutokset haetaan ja yhdistetään paikalliseen haaraasi

Jos tapahtuu merge-konflikteja, Git-paneeli korostaa konfliktissa olevat tiedostot. Avaa jokainen niistä konfliktin ratkaisemiseksi ja lisää sitten ratkaisu stage-alueelle ja tee siitä commit.

Pikapainike Gitin lisäämiseen

Pushauksen jälkeen muutoksesi ovat etärepositoriossa ja tiimisi käytettävissä tai valmiina pull requestia varten. Git-paneeli näyttää, että haarasi on ajan tasalla etärepositorion kanssa.