Структура кода и комментарии

JavaScript-код состоит из инструкций, которые выполняются сверху вниз. Инструкции заканчиваются точкой с запятой (;). Блоки кода заключаются в фигурные скобки {}. Комментарии начинаются с // (однострочные) или /* ... */ (многострочные).

Инструкции (statements) — это команды JavaScript: let x = 10; // инструкция объявления console.log(x); // инструкция вызова

Точки с запятой: JavaScript может работать без точек с запятой (ASI — Automatic Semicolon Insertion), но это может приводить к неожиданным ошибкам. Рекомендуется всегда ставить ;.

Фигурные скобки {}: Определяют блоки кода: функции, условия, циклы. Внутри скобок — несколько инструкций.

Комментарии: // однострочный комментарий /* многострочный комментарий */

Комментарии не выполняются JavaScript — они только для людей. Используйте их, чтобы объяснить ЗАЧЁМ написан сложный код.

Пробелы и переносы строк: JavaScript игнорирует лишние пробелы и переносы. Код let x = 10; и let x = 10; работают одинаково. Но правильные отступы делают код читаемым.

Код — это рецепт. Инструкции — шаги рецепта. Скобки — блоки шагов (например, «сделать тесто»). Комментарии — пояснения шеф-повара: «именно поэтому добавляем соль сейчас, а не позже».

**Самый простой:**

// Это комментарий — JavaScript его игнорирует
let name = 'Анна'; // Комментарий в конце строки

console.log(name);

Комментарии начинаются с //. Они не влияют на работу кода, но помогают понять, что происходит.

**Простой:**

/* Многострочный комментарий
   используется для длинных пояснений */

if (age >= 18) {
  console.log('Добро пожаловать');
} else {
  console.log('Вам нет 18');
}

/* ... */ — многострочный комментарий. { } — блок кода для условия.

**Реальный пример:**

// Плохо:
let x = 10; let y = 20; let z = x + y;

// Хорошо:
let firstNumber = 10;
let secondNumber = 20;
let sum = firstNumber + secondNumber;
// Считаем сумму двух чисел для отображения в интерфейсе

Читаемые имена переменных + комментарии = код, который понимают другие разработчики (и вы через неделю).

**Неправильно:** Писать весь код в одну строку

**Почему:** Нечитаемый код — источник ошибок. Другие (и вы) не смогут его понять.

**Правильно:** Каждая инструкция — на новой строке. Используйте отступы (2 или 4 пробела).

**Неправильно:** Комментировать очевидное

**Почему:** // Инкрементируем счётчик (счётчик += 1) — это не помогает, а загромождает.

**Правильно:** Комментируйте ЗАЧЁМ, а не ЧТО. Если код понятен из имён переменных — комментарий не нужен.

**Неправильно:** Забывать точки с запятой

**Почему:** Без ; JavaScript может неправильно понять границы инструкций.

**Правильно:** Всегда ставьте ; в конце инструкций.

• // — однострочный комментарий
• /* ... */ — многострочный комментарий
• Код выполняется сверху вниз
• Комментируйте ЗАЧЁМ, а не ЧТО
• Используйте отступы для читаемости

Назад: Вы знаете операторы (J4) — теперь вы умеете правильно структурировать код.

Вперёд: Следующий урок (J6) — взаимодействие с браузером: alert(), prompt() и confirm().