Установить Node.js и запустить первый скрипт без ошибок

К концу этой инструкции у вас будет установленный Node.js, работающая команда node в терминале и первый скрипт, который вы запустите и увидите результат. На всё уйдёт 10–15 минут, если ничего не пойдёт не так. А если пойдёт — в конце есть раздел с реальными текстами ошибок и что с ними делать.

Node.js — это среда, которая позволяет запускать код на JavaScript вне браузера: на вашем компьютере или на сервере. Дальше речь про версию Node.js 22.x LTS — это актуальная линия с долгой поддержкой на момент написания. Если у вас установилась другая LTS-версия (20.x), команды из инструкции работают так же.

Что нужно иметь до начала

• Компьютер на Windows 10/11, macOS или Linux.
• Права администратора — установщик Node.js под Windows и macOS попросит их сам.
• Терминал: на Windows это PowerShell или Командная строка, на macOS — Terminal, на Linux — любой эмулятор терминала.
• Любой текстовый редактор. Подойдёт даже «Блокнот», но удобнее VS Code или Notepad++.

Отдельная программа для JavaScript не нужна — Node.js сам умеет запускать файлы.

Шаг 1. Скачать установщик

1. Откройте официальный сайт nodejs.org. Не качайте Node.js со сторонних сайтов и торрентов — под видом установщика туда часто подкладывают лишнее.
2. На главной странице выберите вариант с пометкой LTS (Long Term Support). Второй вариант, Current, содержит самые новые возможности, но менее стабилен — новичку он не нужен.
3. Сайт сам определит вашу операционную систему и предложит нужный файл: .msi для Windows, .pkg для macOS.

Проверка: в папке загрузок появился файл вроде node-v22.x.x-x64.msi.

Шаг 2. Установить

Windows

Запустите скачанный .msi-файл и на всех экранах нажимайте «Next», не снимая галочки. Один экран важен: пункт «Add to PATH» должен остаться отмеченным — именно он делает так, что команда node начинает работать в терминале. По умолчанию галочка стоит, не трогайте её.

macOS

Откройте .pkg и пройдите установщик до конца. PATH настроится автоматически.

Linux

На Ubuntu/Debian не ставьте Node из стандартного apt — там обычно устаревшая версия. Используйте официальный репозиторий NodeSource или менеджер версий nvm. Актуальную команду для вашей версии дистрибутива смотрите в разделе установки на GitHub Node.js — она меняется вместе с релизами.

Проверка: установщик завершился без ошибок и сообщил, что установка прошла успешно.

Шаг 3. Проверить, что установилось

Закройте все открытые окна терминала и откройте новое — это важно, потому что терминал читает переменную PATH только при запуске. Введите две команды по очереди:

node --version
npm --version

Первая покажет версию Node.js, вторая — версию npm, менеджера пакетов, который ставится вместе с Node.

Проверка: вы увидите что-то вроде:

v22.11.0
10.9.0

Номера у вас могут отличаться — это нормально. Главное, что обе команды что-то вывели, а не выдали ошибку.

Если вы забыли закрыть и открыть терминал заново после установки, команда node не найдётся, хотя всё поставлено правильно. Это ошибка номер один у новичков — и лечится она перезапуском терминала.

Шаг 4. Написать первый скрипт

Создайте на рабочем столе или в любой удобной папке файл hello.js. Именно с расширением .js, а не .js.txt — про эту ловушку ниже. Впишите в него одну строку:

console.log("Node.js работает");

Функция console.log выводит текст в терминал — это самый простой способ увидеть, что скрипт выполнился.

Шаг 5. Запустить

В терминале перейдите в папку, где лежит файл. Если файл на рабочем столе:

cd Desktop

На Windows папка рабочего стола тоже называется Desktop, даже если в проводнике вы видите «Рабочий стол». Затем запустите:

node hello.js

Проверка: в терминале появится строка:

Node.js работает

Если появилась — поздравляю, всё работает. Дальше — разбор ситуаций, когда что-то пошло не так.

Если не получилось

«node не является внутренней или внешней командой» / «command not found: node»

Терминал не нашёл Node. Две причины по частоте:

1. Вы не перезапустили терминал после установки. Закройте окно, откройте новое, повторите node --version.
2. При установке на Windows была снята галочка «Add to PATH». Переустановите Node.js через тот же .msi, оставив галочку на месте.

«Cannot find module 'C:\Users\...\hello.js'» или «Error: Cannot find module»

Node не нашёл файл. Вы либо запускаете команду не из той папки, либо неправильно указали имя. Проверьте, что вы в нужной директории: на Windows команда dir, на macOS и Linux — ls — покажет список файлов. Файл hello.js должен быть в этом списке.

Файл называется hello.js.txt вместо hello.js

Классическая ловушка «Блокнота» на Windows: проводник по умолчанию скрывает расширения, и файл, который вы назвали hello.js, на диске лежит как hello.js.txt. Node такой файл запустит, но не найдёт hello.js. Включите показ расширений: в проводнике вкладка «Вид» → галочка «Расширения имён файлов». Затем переименуйте файл, убрав .txt.

«SyntaxError: ...»

Скрипт запустился, но в коде опечатка. Чаще всего — пропущена кавычка или скобка. Сравните свою строку с образцом посимвольно. Кавычки должны быть прямыми ("), а не «ёлочками», которые иногда подставляет автозамена в редакторах.

Как не запутаться в версиях дальше

Когда вы начнёте работать с разными проектами, окажется, что одному нужна Node 20, другому — 22. Держать одну версию на всю систему неудобно. Для этого есть менеджеры версий — они позволяют переключаться одной командой.

Пока вам одна версия хватает — менеджер не нужен, установка с сайта проще. Вернётесь к этому вопросу, когда столкнётесь с проектом, который требует конкретную версию.

Что делать дальше

Первый скрипт запущен. Следующий разумный шаг — создать проект с package.json: выполните npm init -y в пустой папке, и появится файл, где npm хранит список зависимостей проекта. После этого вы сможете ставить сторонние библиотеки командой npm install и подключать их в коде. Установку и работу с зависимостями разберём отдельно — здесь мы дошли до рабочего окружения и первого запуска, и этого достаточно, чтобы двигаться дальше.