Kommentare und übersichtliche Sketches
Schreiben und strukturieren Sie Code so, dass er lesbar bleibt
Kommentare und übersichtliche Sketches ist eine kostenlose Arduino & IoT Academy-Lektion auf CoddyKit. Dies ist Lektion 3 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Arduino & IoT Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Arduino & IoT Academy-Kurs umfasst insgesamt 4 Lektionen.
Notizen für Menschen
Code wird viel häufiger gelesen als geschrieben. Kommentare sind Notizen, die Sie hinterlassen, damit Ihr zukünftiges Ich den Sketch versteht. 📝
Der einzeilige Kommentar
Geben Sie zwei Schrägstriche ein, wird der Rest dieser Zeile zu einem Kommentar. Das Board ignoriert ihn bei der Ausführung Ihres Codes vollständig.
// this line is just a note
digitalWrite(13, HIGH);Kommentare am Zeilenende
Sie können nach echtem Code in derselben Zeile einen Kommentar ergänzen. Er erklärt genau diesen Schritt, ohne etwas zu beeinträchtigen. Praktisch für einen kurzen Kontext.
delay(1000); // pause for one secondDer Blockkommentar
Für längere Notizen setzen Sie Text zwischen Schrägstrich-Stern und Stern-Schrägstrich. Dieser Block kann sich über mehrere Zeilen erstrecken und eignet sich gut für Beschreibungen.
/* This sketch blinks
the onboard LED. */Kommentare werden nicht ausgeführt
Alles innerhalb eines Kommentars ist für das Board unsichtbar. Kommentare sind ausschließlich für Lesende gedacht und beeinflussen daher nie das Verhalten Ihres Geräts.
Erklären Sie warum, nicht was
Gute Kommentare erklären, warum eine Zeile vorhanden ist, und nicht nur, was sie tut. Notieren Sie den Grund, denn die Aktion ist bereits im Code zu sehen.
delay(20); // debounce noisy buttonEinrückung erleichtert das Lesen
Zeilen innerhalb von Klammern sollten um einige Leerzeichen eingerückt werden. Diese Einrückung zeigt, was zusammengehört, und macht die Logik leicht überblickbar.
void setup() {
pinMode(13, OUTPUT);
}Benennen Sie Dinge eindeutig
Ein klarer Name ist besser als ein Kommentar. Wenn Sie einen Pin ledPin statt einfach mit einer Zahl benennen, erkennt die lesende Person sofort, was er steuert.
int ledPin = 13;Zum Testen auskommentieren
Deaktivieren Sie eine Zeile vorübergehend, indem Sie Schrägstriche davor setzen. Durch das Auskommentieren können Sie testen, ohne Code zu löschen, den Sie später wieder benötigen.
// digitalWrite(13, LOW);Vermeiden Sie offensichtliche Unordnung
Kommentieren Sie nicht jede einzelne Zeile. Ein Kommentar wie „eins zu x addieren“ sorgt für Unordnung, nicht für zusätzlichen Wert. Heben Sie Notizen für die Stellen auf, die wirklich erklärt werden müssen.
Saubere Sketches zahlen sich aus
Ordentliche Abstände, eindeutige Namen und nützliche Kommentare machen einen Sketch auch Monate später leicht zu ändern. Lesbarer Code ist zuverlässiger Code.
Kurzer Test
Prüfen wir, was ein Kommentar bewirkt.
Rückblick: Saubere Sketches
Sie haben gelernt, Kommentare mit // und Schrägstrich-Stern zu verwenden, innerhalb von Klammern einzurücken und Dinge eindeutig zu benennen. Lesbare Sketches bleiben leicht zu warten. 🎉
Lerne C++ mit einem KI-Tutor — kostenlos
Schreibe und führe echten Code in deinem Browser aus, bekomme sofortige Hilfe von einem 24/7 KI-Tutor und setze dein Lernen im Web oder in der App fort.
- Kurse
- 30
- Lektionen
- 120
Häufig gestellte Fragen
Ist die Lektion „Kommentare und übersichtliche Sketches“ kostenlos?
Ja — der vollständige Text von „Kommentare und übersichtliche Sketches“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Arduino & IoT Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Arduino & IoT Academy-Kurs umfasst insgesamt 4 Lektionen.
Was lerne ich in „Kommentare und übersichtliche Sketches“?
Schreiben und strukturieren Sie Code so, dass er lesbar bleibt Du übst Arduino & IoT Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.
Brauche ich Erfahrung, um Arduino & IoT Academy zu starten?
Keine Vorkenntnisse erforderlich. Arduino & IoT Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 3 von 4.
Wie lange dauert die Lektion „Kommentare und übersichtliche Sketches“?
Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.
Kann ich in dieser Arduino & IoT Academy-Lektion Code schreiben und ausführen?
Ja. Jede Arduino & IoT Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.
Alle Lektionen in diesem Kurs
- setup() wird einmal ausgeführt
- loop() läuft dauerhaft
- Kommentare und übersichtliche Sketches
- Kompilierfehler und ihr Verständnis