Как начать разработку на Node.js: первый проект, файл и запуск

Короткий ответ: начните не с большого фреймворка, а с маленькой папки проекта и одного файла index.js. Если команда node index.js выводит текст в терминал, значит Node.js установлен, код запускается, а дальше уже можно добавлять npm-пакеты, сервер Express, работу с файлами и базой данных

Этот материал закрывает запросы вроде «node js разработка», «node.js как пользоваться», «node js начало работы», «как запустить node js», «как пользоваться node js в windows» и «node js гайд». Интент у этих запросов простой: человек не ищет теорию движка V8, ему нужно понять, что открыть, куда писать код и какую команду запускать

Что нужно перед стартом

Проверьте, что Node.js установлен. Откройте терминал и выполните две команды

node -v
npm -v

Если обе команды показывают версии, можно начинать. Если node не находится, сначала вернитесь к материалам по установке Node.js и PATH, потому что без работающего терминала разработка будет выглядеть как череда странных ошибок

Создайте папку проекта

Сделайте отдельную папку, например node-start. Это важно: новичок часто пишет файлы прямо на рабочем столе, потом теряет их, смешивает разные уроки и не понимает, из какой папки запускается команда

mkdir node-start
cd node-start

На Windows эти команды можно выполнить в PowerShell или терминале Visual Studio Code. На macOS и Linux — в обычном Terminal. Если вы не хотите работать командами, создайте папку руками, откройте ее в редакторе и уже там откройте встроенный терминал

Напишите первый файл

Создайте файл index.js и вставьте в него такой код

const userName = "Динар";
const firstNumber = 10;
const secondNumber = 15;

const sum = firstNumber + secondNumber;

console.log(`Привет, ${userName}`);
console.log(`Сумма: ${sum}`);

Это обычный JavaScript, но выполняется он не в браузере, а в Node.js. В браузере JavaScript работает внутри страницы, а здесь код запускается как программа на компьютере: читает файлы, работает с пакетами, поднимает сервер, ходит в базу данных и выполняет скрипты из терминала

Запустите код

В терминале, открытом внутри папки node-start, выполните

node index.js

Нормальный вывод будет таким

Привет, Динар
Сумма: 25

Если вы видите этот вывод, первый этап пройден. Node.js получил файл, выполнил строки сверху вниз и показал результат через console.log()

Что происходит внутри

Команда node index.js говорит Node.js: возьми файл index.js и выполни его как программу. В этом файле мы создаем три значения, складываем два числа и выводим результат в терминал. Здесь пока нет браузера, HTML, кнопок и формы, поэтому весь результат появляется именно в консоли

Новичку важно ухватить эту механику: Node.js не «открывается» как отдельная программа для написания кода. Код пишется в редакторе, а Node.js запускает файлы через терминал. Редактор нужен для удобного письма, Node.js — для исполнения, терминал — для команд и вывода

Как превратить это в настоящий проект

Следующий шаг — создать package.json. Этот файл описывает проект: его имя, команды запуска и зависимости. Выполните

npm init -y

После этого в папке появится package.json. В него можно добавить команду запуска

{
  "scripts": {
    "start": "node index.js"
  }
}

Теперь проект можно запускать не только через node index.js, но и через

npm start

На маленьком примере это выглядит лишним, но в реальных проектах через npm start запускают сервер, сборку, проверку кода и другие команды

Мини-практика

Поменяйте имя в userName, затем измените числа firstNumber и secondNumber. Запустите файл еще раз и проверьте, что вывод поменялся. После этого добавьте третье число и выведите новую сумму

const thirdNumber = 5;
console.log(`Новая сумма: ${firstNumber + secondNumber + thirdNumber}`);

Такой маленький опыт полезнее, чем пассивное чтение: вы сразу видите связь между кодом и выводом в терминале

Частые ошибки

Команда node index.js не работает Проверьте, что терминал открыт именно в папке, где лежит index.js. Команда dir на Windows или ls на macOS/Linux покажет список файлов текущей папки

Терминал пишет node: command not found Node.js не установлен или не добавлен в PATH. Проверьте node -v и вернитесь к материалу про установку Node.js

В терминале ничего не выводится Проверьте, есть ли в файле console.log(). Если программа что-то считает, но не печатает результат, новичку кажется, что код не работает, хотя он просто не выводит данные наружу

Файл назван index.js.txt Такое бывает на Windows, если расширения скрыты. Включите отображение расширений файлов или создавайте файл прямо в редакторе кода

Что почитать дальше по Node.js

Если нужен общий маршрут по теме, откройте рубрику Node.js. Для соседних задач пригодятся эти разборы:

• Как запустить JS-файл через Node.js: терминал, папка и первый вывод
• Как в Node.js Express отдать файл по ссылке: sendFile и static
• Как запустить проект Node.js: npm install, package.json и команды start/dev
• Как инициализировать проект Node.js с package.json и первым запуском