Git og GitHub for makers: Versjonskontroll av prosjektene dine

Har du noensinne ødelagt et viktig prosjekt og ønsket du kunne «angre» til en tidligere versjon? Eller mistet oversikten når du eksperimenterer med ny kode? Git og GitHub er verktøyene som løser disse problemene for makers og utviklere verden over.

Hva er Git og GitHub?

Git er et versjonskontrollsystem som holder styr på endringer i filene dine over tid. Tenk på det som en avansert «angre»-funksjon som husker hele historikken til prosjektet ditt. GitHub er en skybasert tjeneste som lagrer Git-repositoriene dine online, slik at du kan dele prosjekter og samarbeide med andre.

For makers er dette gull verdt når du arbeider med Arduino-kode, 3D-modeller, dokumentasjon eller andre digitale prosjektfiler. Du kan eksperimentere trygt, dele arbeidet med andre, og alltid gå tilbake til en fungerende versjon.

Installasjon av Git

Windows

1. Gå til git-scm.com og last ned Git for Windows
2. Kjør installasjonsfilen og følg standardinnstillingene
3. Åpne «Git Bash» fra startmenyen

Mac

1. Åpne Terminal
2. Skriv git --version – dette installerer Git automatisk hvis det ikke finnes
3. Følg instruksjonene som dukker opp

Linux

Installer via pakkebehandleren din:

sudo apt install git (Ubuntu/Debian)
sudo dnf install git (Fedora)

Første oppsett

Konfigurer Git med ditt navn og e-post:


git config --global user.name "Ditt Navn"
git config --global user.email "din.epost@example.com"


Opprett GitHub-konto og ditt første repository

1. Gå til github.com og opprett en gratis konto
2. Klikk på «New repository» (grønn knapp)
3. Gi repositoriet et navn, for eksempel «mitt-arduino-prosjekt»
4. Velg «Public» for å dele med andre, eller «Private» for personlig bruk
5. Huk av «Add a README file»
6. Klikk «Create repository»

Tips: Bruk beskrivende repository-navn uten mellomrom. Erstatt mellomrom med bindestreker, som «led-matrix-klokke» i stedet for «LED Matrix Klokke».

Grunnleggende Git-kommandoer: Clone, Add, Commit, Push

Steg 1: Clone (Last ned) repositoriet

Gå til ditt GitHub-repository og klikk på grønn «Code»-knapp. Kopier URL-en og kjør:

git clone https://github.com/dittbrukernavn/ditt-repository.git

Dette laster ned en lokal kopi av repositoriet til datamaskinen din.

Steg 2: Legg til filer

Naviger inn i mappen og legg til prosjektfilene dine. Deretter «stage» filene for commit:


cd ditt-repository
git add .


git add . legger til alle endrede filer. Du kan også legge til spesifikke filer med git add filnavn.ino.

Steg 3: Commit (Lagre snapshot)

Lag et «snapshot» av endringene med en beskrivende melding:

git commit -m "Lagt til LED-blinking kode"

Steg 4: Push (Send til GitHub)

Send endringene til GitHub:

git push origin main

Tips: Skriv gode commit-meldinger som forklarer HVA du endret, ikke hvordan. «Fikset sensor-kalibrering» er bedre enn «Endret linje 42».

Pull: Hent endringer fra GitHub

Hvis du arbeider på flere datamaskiner eller samarbeider med andre, bruk git pull for å hente de nyeste endringene før du begynner å jobbe:

git pull origin main

Branching: Eksperimenter trygt

Branches (grener) lar deg eksperimentere med nye funksjoner uten å påvirke hovedkoden. Tenk på det som parallelle versjoner av prosjektet ditt.

Opprett og bytt til ny branch


git checkout -b ny-sensor-funksjon
git push -u origin ny-sensor-funksjon


Bytt mellom branches


git checkout main # Tilbake til hovedgrenen
git checkout ny-sensor-funksjon # Til eksperiment-grenen


Merge branches

Når eksperimentet fungerer, kan du slå det sammen med hovedkoden:


git checkout main
git merge ny-sensor-funksjon
git push origin main


Tips: Bruk beskrivende branch-navn som «lcd-display-support» eller «wifi-forbindelse». Unngå navn som «test» eller «ny-kode».

GitHub Pages: Publiser prosjekt-dokumentasjon

GitHub Pages lar deg lage gratis nettsider direkte fra repositoriet ditt – perfekt for prosjektdokumentasjon.

1. Gå til repository-innstillingene på GitHub
2. Scroll ned til «Pages» i venstre meny
3. Under «Source», velg «Deploy from a branch»
4. Velg «main» branch og «/ (root)» mappe
5. Klikk «Save»

Opprett en index.html eller README.md fil i repositoriet ditt, og den vil bli tilgjengelig på dittbrukernavn.github.io/ditt-repository.

Vanlige feil og løsninger

1. «Permission denied» ved push

Du må autentisere deg. Bruk Personal Access Token i stedet for passord, eller sett opp SSH-nøkler. GitHub har fjernet støtte for passord-autentisering.

2. «Your branch is behind» melding

Noen andre har pushhet endringer. Kjør git pull først, deretter git push.

3. Merge conflicts

Oppstår når samme linje er endret i to branches. Git markerer konfliktene i filen – rediger manuelt og commit løsningen.

4. Glemt å legge til filer før commit

Bruk git add . og deretter git commit --amend for å legge til flere filer i forrige commit.

5. Vil angre siste commit

Bruk git reset --soft HEAD~1 for å angre commit men beholde endringene, eller git reset --hard HEAD~1 for å slette alt.

Neste steg

Nå som du behersker grunnleggende Git og GitHub, kan du utforske mer avanserte funksjoner som GitHub Actions for automatisk testing, eller GitLab som alternativ. Husk at versjonskontroll blir en naturlig del av arbeidsflyten din – jo mer du bruker det, jo mer uunnværlig blir det.

Start med et enkelt Arduino-prosjekt eller 3D-modell, og bygg opp vanene dine. Dine fremtidige selv vil takke deg når du kan spore alle endringer og eksperimentere uten frykt for å miste arbeidet!