Kommentarer og ryddige skisser
Skriv notater og organiser koden slik at den forblir lesbar
Kommentarer og ryddige skisser er en gratis leksjon i Arduino & IoT Academy på CoddyKit. Dette er leksjon 3 av 4. Du kan lese hele leksjonen gratis nedenfor – og deretter øve praktisk i nettleseren med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt. Den er en del av læringsløpet i Arduino & IoT Academy, og fremdriften din synkroniseres mellom nettet og CoddyKit-appen. Kurset i Arduino & IoT Academy inneholder totalt 4 leksjoner.
Notater for mennesker
Kode leses langt oftere enn den skrives. Kommentarer er notater du legger igjen, slik at fremtidige deg forstår sketchen. 📝
Kommentar på én linje
Skriv to skråstreker, så blir resten av linjen en kommentar. Kortet ignorerer den fullstendig når koden kjøres.
// this line is just a note
digitalWrite(13, HIGH);Kommentarer på slutten av linjen
Du kan legge en kommentar etter ekte kode på samme linje. Den forklarer akkurat dette steget uten å forstyrre noe. Nyttig når du trenger litt rask kontekst.
delay(1000); // pause for one secondBlokkkommentaren
For lengre notater kan du sette teksten mellom en skråstrek-stjerne og en stjerne-skråstrek. Denne blokken kan gå over flere linjer og egner seg godt til beskrivelser.
/* This sketch blinks
the onboard LED. */Kommentarer kjøres ikke
Alt som står i en kommentar, er usynlig for kortet. Det er bare for lesere og påvirker derfor aldri hvordan enheten oppfører seg.
Forklar hvorfor, ikke hva
Gode kommentarer sier hvorfor en linje finnes, ikke bare hva den gjør. Skriv ned årsaken, siden koden allerede viser handlingen.
delay(20); // debounce noisy buttonInnrykk gjør koden lettere å lese
Linjer mellom krøllparenteser bør rykkes inn noen mellomrom. Dette innrykket viser hva som hører sammen og gjør logikken lett å skanne.
void setup() {
pinMode(13, OUTPUT);
}Gi ting tydelige navn
Et tydelig navn er bedre enn en kommentar. Hvis du kaller en pin ledPin i stedet for bare et tall, ser leseren nøyaktig hva den styrer.
int ledPin = 13;Kommenter ut for å teste
Deaktiver en linje midlertidig ved å legge skråstreker foran den. Utkommentering lar deg teste uten å slette kode du kanskje vil bruke igjen.
// digitalWrite(13, LOW);Unngå åpenbart rot
Ikke fortell historien til hver eneste linje. En kommentar som «legg én til x» skaper rot, ikke verdi. Spar notatene til det som virkelig trenger forklaring.
Ryddige sketcheer varer lengst
Ryddig mellomrom, tydelige navn og nyttige kommentarer gjør en sketch enkel å rette flere måneder senere. Lesbar kode er pålitelig kode.
Hurtigsjekk
La oss sjekke hva en kommentar gjør.
Oppsummering: ryddige sketcheer
Du har lært å bruke kommentarer med // og skråstrek-stjerne, rykke inn kode mellom krøllparenteser og gi ting tydelige navn. Lesbare sketcheer er enkle å vedlikeholde. 🎉
Lær deg C++ med en AI-veileder – gratis
Skriv og kjør ekte kode i nettleseren, få umiddelbar hjelp fra en AI-veileder som er tilgjengelig døgnet rundt, og fortsett der du slapp – på nettet eller i appen.
- Kurs
- 30
- Leksjoner
- 120
Ofte stilte spørsmål
Er leksjonen «Kommentarer og ryddige skisser» gratis?
Ja – hele teksten i «Kommentarer og ryddige skisser» er gratis å lese her på nettet. For å øve interaktivt med en innebygd kodeeditor og en AI-veileder som er tilgjengelig døgnet rundt, og for å låse opp resten av Arduino & IoT Academy-kurset, kan du oppgradere til CoddyKit PRO. Kurset i Arduino & IoT Academy inneholder totalt 4 leksjoner.
Hva lærer jeg i «Kommentarer og ryddige skisser»?
Skriv notater og organiser koden slik at den forblir lesbar Du øver på Arduino & IoT Academy med praktisk kode som du kjører direkte i nettleseren, mens en AI-veileder som er tilgjengelig døgnet rundt, svarer på spørsmålene dine mens du jobber deg gjennom leksjonen.
Trenger jeg erfaring for å begynne med Arduino & IoT Academy?
Ingen tidligere erfaring er nødvendig. Arduino & IoT Academy på CoddyKit er lagt opp for både nybegynnere og viderekomne, så De kan begynne her eller helt fra start og lære i Deres eget tempo. Dette er leksjon 3 av 4.
Hvor lang tid tar leksjonen «Kommentarer og ryddige skisser»?
De fleste CoddyKit-leksjoner tar omtrent 5–10 minutter. Hver leksjon er kort og interaktiv, slik at De gjør jevne fremskritt og kan fortsette akkurat der De slapp – både på nettet og i appen.
Kan jeg skrive og kjøre kode i denne Arduino & IoT Academy-leksjonen?
Ja. Alle Arduino & IoT Academy-leksjoner har en innebygd kodeeditor, slik at De kan skrive og kjøre ekte kode direkte i nettleseren og få umiddelbar tilbakemelding fra AI – uten lokal konfigurering.
Alle leksjonene i dette kurset
- setup() kjører én gang
- loop() kjører for alltid
- Kommentarer og ryddige skisser
- Kompileringsfeil og hvordan du leser dem