Lección 04: Sintaxis y Comentarios

🧠 Concepto

La sintaxis de un lenguaje son las reglas que determinan cómo escribir código válido. En JavaScript, la sintaxis es relativamente flexible en comparación con otros lenguajes, pero tiene sus propias reglas.

Instrucciones (Statements)

Una instrucción es una línea de código que realiza una acción. Las instrucciones suelen terminar con punto y coma (;).

let nombre = 'Ana';   // instrucción de asignación
console.log(nombre);  // instrucción de llamada a función

Bloques de código { }

Las llaves {} agrupan varias instrucciones en un bloque. Se usan con funciones, condicionales, bucles, etc.

{
  let mensaje = 'Dentro del bloque';
  console.log(mensaje);
}

Comentarios

Los comentarios son texto que el programador escribe para explicar el código, pero que JavaScript ignora al ejecutar.

Comentario de una línea: usa //

// Esto es un comentario de una línea
let x = 5; // también puedes comentar al final de una línea

Comentario de múltiples líneas: usa /* */

/*
  Esto es un comentario
  de varias líneas.
  Muy útil para explicar secciones complejas.
*/
let y = 10;

Comentarios JSDoc (para documentar funciones):

/**
 * Suma dos números
 * @param {number} a - Primer número
 * @param {number} b - Segundo número
 * @returns {number} La suma de a y b
 */
function sumar(a, b) {
  return a + b;
}

💻 Ejemplo

// ====================================
// Programa: calculadora simple
// Autor: Estudiante del curso
// ====================================

/*
  Este programa realiza operaciones
  matemáticas básicas con dos números.
*/

let num1 = 10;
let num2 = 5;

let suma = num1 + num2; // aquí sumamos los números
console.log('La suma es:', suma);

📝 Ejercicio

1. Crea un archivo comentarios.js.
2. Escribe un comentario de una línea que diga tu nombre y la fecha.
3. Escribe un comentario multilínea explicando qué esperas aprender en este curso.
4. Debajo de los comentarios, escribe: console.log('Aprendiendo a comentar código');
5. Ejecuta el archivo con Node.js.

Ejemplo:

// Autor: Juan García - 15/01/2025

/*
  En este curso espero aprender:
  - Fundamentos de JavaScript
  - Manipulación del DOM
  - Funciones y objetos
*/

console.log('Aprendiendo a comentar código');

⚠️ Nota

Los comentarios no deben explicar el qué (el código ya lo muestra), sino el por qué. Mal comentario: x = x + 1; // incrementa x en 1 (obvio). Buen comentario: x = x + 1; // compensa el offset del índice base 0.

🎯 Tip

VS Code tiene atajos para comentar:

• Ctrl + / — comenta o descomenta la línea actual
• Shift + Alt + A — comenta bloque seleccionado

Úsalos constantemente para agilizar tu trabajo.