Arduino & IoT Academy · Pelajaran

Komentar & Sketch yang Rapi

Menulis catatan dan menyusun kode agar tetap mudah dibaca

Pelajaran 3 dari 413 langkah

Komentar & Sketch yang Rapi adalah pelajaran Arduino & IoT Academy gratis di CoddyKit. Ini adalah pelajaran 3 dari 4. Kamu bisa membaca pelajaran lengkapnya di bawah secara gratis — lalu praktikkan langsung di browser dengan editor kode bawaan dan tutor AI 24/7. Ini adalah bagian dari jalur belajar Arduino & IoT Academy, dan progresmu tersinkronisasi di web dan aplikasi CoddyKit. Kursus Arduino & IoT Academy mencakup 4 pelajaran total.

Catatan untuk Manusia

Kode jauh lebih sering dibaca daripada ditulis. Komentar adalah catatan yang Anda tinggalkan agar diri Anda di masa mendatang memahami sketsa tersebut. 📝

Komentar Satu Baris

Ketik dua garis miring dan sisa baris tersebut menjadi komentar. Papan mengabaikannya sepenuhnya saat menjalankan kode Anda.

// this line is just a note
digitalWrite(13, HIGH);

Komentar di Akhir Baris

Anda dapat menambahkan komentar setelah kode yang sebenarnya pada baris yang sama. Komentar tersebut menjelaskan langkah itu tanpa mengganggu apa pun. Berguna untuk konteks singkat.

delay(1000); // pause for one second

Komentar Blok

Untuk catatan yang lebih panjang, apit teks di antara garis miring-bintang dan bintang-garis miring. Blok ini dapat mencakup beberapa baris dan cocok untuk penjelasan.

/* This sketch blinks
   the onboard LED. */

Komentar Tidak Dijalankan

Apa pun yang berada di dalam komentar tidak terlihat oleh papan. Komentar hanya ditujukan untuk pembaca, sehingga tidak pernah memengaruhi perilaku perangkat Anda.

Jelaskan Mengapa, Bukan Apa

Komentar yang baik menjelaskan mengapa sebuah baris ada, bukan sekadar apa yang dilakukannya. Catat alasannya, karena kode sudah menunjukkan tindakannya.

delay(20); // debounce noisy button

Indentasi Membantu Pembacaan

Baris di dalam kurung kurawal sebaiknya digeser masuk beberapa spasi. Indentasi ini menunjukkan bagian yang saling berkaitan dan membuat logika mudah dipindai.

void setup() {
  pinMode(13, OUTPUT);
}

Beri Nama dengan Jelas

Nama yang jelas lebih baik daripada komentar. Menamai pin sebagai ledPin, bukan sekadar angka, memberi tahu pembaca dengan tepat apa yang dikendalikannya.

int ledPin = 13;

Nonaktifkan Komentar untuk Menguji

Nonaktifkan sementara sebuah baris dengan menambahkan garis miring di depannya. Menjadikannya komentar memungkinkan Anda menguji kode tanpa menghapus kode yang mungkin ingin digunakan kembali.

// digitalWrite(13, LOW);

Hindari Kerumitan yang Jelas

Jangan menjelaskan setiap baris. Komentar seperti menambahkan satu ke x hanya menambah kerumitan, bukan manfaat. Simpan catatan untuk bagian yang benar-benar perlu dijelaskan.

Sketsa yang Rapi untuk Jangka Panjang

Spasi yang rapi, nama yang jelas, dan komentar yang berguna membuat sketsa mudah diperbaiki berbulan-bulan kemudian. Kode yang mudah dibaca adalah kode yang andal.

Pemeriksaan Singkat

Mari kita periksa fungsi komentar.

Rangkuman: Sketsa yang Rapi

Anda telah mempelajari cara menggunakan komentar dengan // dan garis miring-bintang, melakukan indentasi di dalam kurung kurawal, serta memberi nama dengan jelas. Sketsa yang mudah dibaca tetap mudah dirawat. 🎉

Gratis untuk memulai

Belajar C++ dengan tutor AI — gratis

Tulis dan jalankan kode asli di browser kamu, dapatkan bantuan instan dari tutor AI 24/7, dan lanjutkan di mana kamu tinggalkan di web atau aplikasi.

Kursus
30
Pelajaran
120

Pertanyaan yang Sering Diajukan

Apakah pelajaran “Komentar & Sketch yang Rapi” gratis?

Ya — teks lengkap “Komentar & Sketch yang Rapi” gratis dibaca di sini di web. Untuk praktiknya secara interaktif (editor kode bawaan dan tutor AI 24/7) dan buka sisa kursus Arduino & IoT Academy, upgrade ke CoddyKit PRO. Kursus Arduino & IoT Academy mencakup 4 pelajaran total.

Apa yang akan aku pelajari di “Komentar & Sketch yang Rapi”?

Menulis catatan dan menyusun kode agar tetap mudah dibaca Kamu berlatih Arduino & IoT Academy dengan kode praktik yang langsung kamu jalankan di browser, dan tutor AI 24/7 menjawab pertanyaanmu saat kamu mengerjakan pelajaran ini.

Apakah aku perlu pengalaman untuk memulai Arduino & IoT Academy?

Tidak diperlukan pengalaman sebelumnya. Arduino & IoT Academy di CoddyKit dirancang untuk pemula hingga pelajar tingkat lanjut, jadi kamu bisa memulai di sini atau dari awal dan belajar sesuai kecepatan kamu sendiri. Ini adalah pelajaran 3 dari 4.

Berapa lama pelajaran “Komentar & Sketch yang Rapi” memakan waktu?

Sebagian besar pelajaran CoddyKit memakan waktu sekitar 5–10 menit. Setiap pelajaran ringkas dan interaktif, jadi kamu membuat kemajuan stabil dan melanjutkan dari tempat kamu tinggalkan di web dan aplikasi.

Bisakah aku menulis dan menjalankan kode dalam pelajaran Arduino & IoT Academy ini?

Ya. Setiap pelajaran Arduino & IoT Academy menyertakan editor kode bawaan, jadi kamu menulis dan menjalankan kode nyata langsung di browser dan mendapatkan umpan balik AI instan — tidak diperlukan penyiapan lokal.

Semua pelajaran dalam kursus ini

  1. setup() Berjalan Sekali
  2. loop() Berjalan Selamanya
  3. Komentar & Sketch yang Rapi
  4. Error Kompilasi & Cara Membacanya
← Kembali ke Arduino & IoT Academy