Heim  >  Artikel  >  Web-Frontend  >  So schreiben Sie klare und effektive Codekommentare in JavaScript mit besseren Kommentaren

So schreiben Sie klare und effektive Codekommentare in JavaScript mit besseren Kommentaren

Mary-Kate Olsen
Mary-Kate OlsenOriginal
2024-10-31 15:48:31738Durchsuche

How to Write Clear and Effective Code Comments in JavaScript with Better Comments

Bei der Arbeit in JavaScript ist das Schreiben klarer und strukturierter Kommentare für wartbaren Code unerlässlich. Die Better Comments-Erweiterung für Visual Studio Code geht noch einen Schritt weiter, indem sie verschiedene Arten von Kommentaren farblich kodiert, um die Lesbarkeit zu verbessern. Sie können es hier herunterladen. Lassen Sie uns untersuchen, wie Sie es für die besten Kommentierungspraktiken verwenden können.

Arten von Kommentaren mit besseren Kommentaren

Better Comments kategorisiert Kommentare nach Zweck, einschließlich der folgenden Typen:

  1. TODOs (// TODO:): Aufgaben oder Verbesserungen markieren.
  2. Wichtige Hinweise (// !): Markieren Sie wichtige Bereiche in Ihrem Code.
  3. Fragen (// ?): Zur Klärung der Logik oder zum Einholen von Feedback.
  4. Erklärungen (//): Standardkommentare zur Erläuterung von komplexem Code.

1. Erklären Sie das „Warum“, nicht das „Was“

Anstatt noch einmal zu wiederholen, was der Code bewirkt, konzentrieren Sie sich darauf, warum ein bestimmter Code erforderlich ist. Bessere Kommentare ermöglicht uns die Verwendung von // ? um Fragen oder Erklärungen zu markieren, die die Argumentation verdeutlichen.

Beispiel:

javascript
Copy code
// ? Increment by 2 to loop through only odd numbers
for (let i = 1; i < 10; i += 2) {
  console.log(i);
}

2. Verwenden Sie beschreibende Kommentare für komplexe Logik

Für komplexe Logik ist das //! Die Notation kann auf wichtige Abschnitte in Bessere Kommentare hinweisen. Dies hilft zukünftigen Betreuern, wichtige Erklärungen schnell zu erkennen.

Beispiel:

javascript
Copy code
//! Custom sort function to prioritize items with the highest scores, then alphabetically by name
items.sort((a, b) => {
  if (a.score === b.score) return a.name.localeCompare(b.name);
  return b.score - a.score;
});

3. Kommentarfunktionen und -klassen

Geben Sie am Anfang von Funktionen und Klassen Zweck, Eingaben und Ausgaben an. Verwenden Sie zur Verdeutlichung Bessere Kommentare: // ? für erläuternde Kommentare und // TODO für ausstehende Verbesserungen.

Beispiel:

javascript
Copy code
// ? Calculates the total price of items in the cart
// TODO: Add handling for discount codes in future iterations
/**
 * Calculates the total price of items in the cart.
 * @param {Array} items - Array of item objects with price and quantity.
 * @returns {number} - The total price.
 */
function calculateTotal(items) {
  return items.reduce((total, item) => total + item.price * item.quantity, 0);
}

4. Vermeiden Sie überflüssige Kommentare

Vermeiden Sie es, in Kommentaren offensichtliche Informationen anzugeben. Wenn der Funktionsname genericID() klar ist, können Sie den Kommentar vollständig überspringen oder ein einfaches // ? Kommentieren Sie, um bestimmte Designoptionen zu notieren.

Beispiel (zu vermeiden):

javascript
Copy code
// ? Generates a unique identifier string
function generateID() {
  return Math.random().toString(36).substr(2, 9);
}

5. Verwenden Sie einen einheitlichen Stil und eine einheitliche Struktur

Die Einhaltung eines konsistenten Kommentarstils, insbesondere mit Farben für Bessere Kommentare, hilft Teammitgliedern, Kommentare schnell zu verstehen und wichtige Notizen zu erkennen.

6. Halten Sie Kommentare auf dem neuesten Stand

Veraltete Kommentare führen die Leser in die Irre. Mit Bessere Kommentare können Sie // TODO für Erinnerungen verwenden oder //! um Änderungen hervorzuheben.

7. Dokumentieren Sie bekannte Probleme oder Problemumgehungen

Wenn der Code Problemumgehungen oder bekannte Einschränkungen aufweist, dokumentieren Sie diese mit Bessere Kommentare. Der // ! Der Stil kann für kritische Probleme verwendet werden und macht auf bekannte Fehler oder notwendige Korrekturen aufmerksam.

Beispiel:

javascript
Copy code
// ? Increment by 2 to loop through only odd numbers
for (let i = 1; i < 10; i += 2) {
  console.log(i);
}

8. Kommentieren Sie Randfälle

Verwenden Sie // ? in Bessere Kommentare, um Randfälle hervorzuheben und zukünftigen Lesern zu helfen, zu verstehen, warum bestimmte Handhabungen existieren.

Beispiel:

javascript
Copy code
//! Custom sort function to prioritize items with the highest scores, then alphabetically by name
items.sort((a, b) => {
  if (a.score === b.score) return a.name.localeCompare(b.name);
  return b.score - a.score;
});


Abschluss

Mit der Erweiterung Better Comments können Sie Ihre JavaScript-Kommentare effektiver gestalten, indem Sie farbcodierte Tags verwenden, um Absichten zu verdeutlichen, Aufgaben zu markieren, wichtige Abschnitte hervorzuheben und Randfälle zu behandeln. Dieser Ansatz stellt sicher, dass Ihr Code leicht zu verstehen, zu warten und zu erweitern ist.

Viel Spaß beim Codieren und Kommentieren mit Better Comments!

Das obige ist der detaillierte Inhalt vonSo schreiben Sie klare und effektive Codekommentare in JavaScript mit besseren Kommentaren. Für weitere Informationen folgen Sie bitte anderen verwandten Artikeln auf der PHP chinesischen Website!

Stellungnahme:
Der Inhalt dieses Artikels wird freiwillig von Internetnutzern beigesteuert und das Urheberrecht liegt beim ursprünglichen Autor. Diese Website übernimmt keine entsprechende rechtliche Verantwortung. Wenn Sie Inhalte finden, bei denen der Verdacht eines Plagiats oder einer Rechtsverletzung besteht, wenden Sie sich bitte an admin@php.cn