Kommentarer och rena sketcher
Skriv anteckningar och strukturera koden så att den förblir läsbar
Kommentarer och rena sketcher är en gratis lektion i Arduino & IoT Academy på CoddyKit. Detta är lektion 3 av 4. Ni kan läsa hela lektionen gratis nedan och sedan öva praktiskt i webbläsaren med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt. Den ingår i lärvägen för Arduino & IoT Academy, och Era framsteg synkroniseras mellan webben och CoddyKit-appen. Kursen i Arduino & IoT Academy innehåller totalt 4 lektioner.
Anteckningar för människor
Kod läses mycket oftare än den skrivs. Kommentarer är anteckningar som hjälper framtida dig att förstå sketchet. 📝
Kommentar på en rad
Skriv två snedstreck, så blir resten av raden en kommentar. Kortet ignorerar den helt när koden körs.
// this line is just a note
digitalWrite(13, HIGH);Kommentarer i slutet av raden
Du kan lägga till en kommentar efter riktig kod på samma rad. Den förklarar just det steget utan att störa något. Praktiskt när du snabbt behöver sammanhang.
delay(1000); // pause for one secondBlockkommentaren
För längre anteckningar omsluter du texten mellan snedstreck-stjärna och stjärna-snedstreck. Detta block kan sträcka sig över flera rader och passar bra för beskrivningar.
/* This sketch blinks
the onboard LED. */Kommentarer körs inte
Allt i en kommentar är osynligt för kortet. Det är enbart till för läsare och påverkar därför aldrig hur enheten fungerar.
Förklara varför, inte vad
Bra kommentarer förklarar varför en rad finns, inte bara vad den gör. Skriv orsaken, eftersom koden redan visar själva åtgärden.
delay(20); // debounce noisy buttonIndrag underlättar läsningen
Rader inom klammerparenteser bör skjutas in några blanksteg. Detta indrag visar vad som hör ihop och gör logiken lätt att överblicka.
void setup() {
pinMode(13, OUTPUT);
}Ge saker tydliga namn
Ett tydligt namn slår en kommentar. Om du kallar en pinne ledPin i stället för bara ett tal förstår läsaren exakt vad den styr.
int ledPin = 13;Kommentera bort för att testa
Inaktivera tillfälligt en rad genom att lägga snedstreck framför den. Med commenting out kan du testa utan att radera kod som du kanske vill återställa.
// digitalWrite(13, LOW);Undvik uppenbart överflöd
Berätta inte vad varje rad gör. En kommentar som säger att ett läggs till i x skapar bara överflöd, inte värde. Spara anteckningar till sådant som verkligen behöver förklaras.
Snygga sketcher håller längst
Jämna mellanrum, tydliga namn och användbara kommentarer gör ett sketch lätt att ändra även månader senare. Läsbar kod är tillförlitlig kod.
Snabb kontroll
Låt oss kontrollera vad en kommentar gör.
Sammanfattning: snygga sketcher
Du har lärt dig att använda kommentarer med // och snedstreck-stjärna, göra indrag inom klammerparenteser och namnge saker tydligt. Läsbara sketcher är enkla att underhålla. 🎉
Lär dig C++ med en AI-lärare – gratis
Skriv och kör riktig kod i webbläsaren, få omedelbar hjälp av en AI-lärare dygnet runt och fortsätt där du slutade – på webben eller i appen.
- Kurser
- 30
- Lektioner
- 120
Vanliga frågor
Är lektionen ”Kommentarer och rena sketcher” gratis?
Ja – hela texten till ”Kommentarer och rena sketcher” kan läsas gratis här på webben. Om Ni vill öva interaktivt med en inbyggd kodredigerare och en AI-handledare som är tillgänglig dygnet runt och låsa upp resten av kursen i Arduino & IoT Academy, kan Ni uppgradera till CoddyKit PRO. Kursen i Arduino & IoT Academy innehåller totalt 4 lektioner.
Vad lär jag mig i ”Kommentarer och rena sketcher”?
Skriv anteckningar och strukturera koden så att den förblir läsbar Ni övar på Arduino & IoT Academy med praktisk kod som körs direkt i webbläsaren, medan en AI-handledare som är tillgänglig dygnet runt svarar på Era frågor under lektionen.
Behöver jag någon erfarenhet för att börja lära mig Arduino & IoT Academy?
Du behöver inga förkunskaper. Utbildningen i Arduino & IoT Academy på CoddyKit är upplagd för allt från nybörjare till avancerade elever, så att du kan börja här eller från början och gå fram i din egen takt. Detta är lektion 3 av 4.
Hur lång tid tar lektionen ”Kommentarer och rena sketcher”?
De flesta CoddyKit-lektioner tar cirka 5–10 minuter. Varje lektion är kort och interaktiv, så att du gör stadiga framsteg och kan fortsätta precis där du slutade – på webben eller i appen.
Kan jag skriva och köra kod i den här Arduino & IoT Academy-lektionen?
Ja. Varje Arduino & IoT Academy-lektion innehåller en inbyggd kodredigerare, så att du kan skriva och köra riktig kod direkt i webbläsaren och få omedelbar AI-feedback – utan lokal installation.
Alla lektioner i den här kursen
- setup() körs en gång
- loop() körs för alltid
- Kommentarer och rena sketcher
- Kompileringsfel och hur ni läser dem