Node.js

Как запустить проект Node.js: npm install, package.json и команды start/dev

Готовый Node.js-проект обычно запускают не одной универсальной командой, а через команды из package.json. Поэтому правильный путь такой: открыть папку проекта, установить зависимости, посмотреть scripts и выполнить нужный запуск

Если проект скачан с GitHub или передан архивом, почти всегда сначала нужна команда npm install

Короткий ответ

Откройте папку проекта в терминале

cd my-node-project

Установите зависимости

npm install

Посмотрите команды в package.json

{
  "scripts": {
    "start": "node server.js",
    "dev": "nodemon server.js"
  }
}

Запустите нужную команду

npm run start

Или

npm run dev

Как понять, что это Node.js-проект

Главный признак — файл package.json. В нем хранятся зависимости, название проекта и команды запуска

Пример

{
  "name": "demo-server",
  "version": "1.0.0",
  "scripts": {
    "start": "node server.js"
  },
  "dependencies": {
    "express": "^4.18.0"
  }
}

Если package.json есть, проект нужно запускать из папки, где он лежит

Почему сначала нужен npm install

В проекте обычно не хранят папку node_modules, потому что она большая и создается заново. Команда npm install читает package.json и package-lock.json, затем скачивает нужные зависимости

npm install

После этого в проекте появляется папка node_modules

Если пропустить этот шаг, при запуске часто появляется ошибка

Cannot find module 'express'

Это значит, что проект пытается подключить библиотеку, но она еще не установлена

Как выбрать команду запуска

Откройте package.json и найдите блок scripts

{
  "scripts": {
    "start": "node server.js",
    "dev": "vite --host 0.0.0.0",
    "build": "vite build"
  }
}

Команды запускаются так

npm run dev
npm run build

Для start можно использовать и короткий вариант

npm start

Но для начинающего лучше понимать общий принцип: npm run имя_команды

Как запустить один файл без package.json

Если проекта как такового нет, а есть один файл server.js или index.js, можно запустить напрямую

node server.js

Или

node index.js

Но если в папке есть package.json, сначала проверьте scripts. В реальных проектах прямой запуск файла не всегда правильный

Что делать, если проект не запускается

Сначала проверьте Node.js и npm

node -v
npm -v

Затем проверьте, что вы в правильной папке

ls

На Windows

dir

В списке должен быть package.json

Если ошибка связана с версией Node.js, посмотрите требования проекта. Они могут быть в .nvmrc, README.md или package.json

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

Создайте папку node-project-demo, выполните npm init -y, создайте файл index.js и добавьте команду start в package.json

index.js

console.log("Проект Node.js запущен")

Фрагмент package.json

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

Запустите

npm start

Если в консоли появился текст, вы поняли базовую схему запуска Node.js-проекта

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

Ошибка первая: запускать npm start не в той папке. Терминал должен быть открыт там, где лежит package.json

Ошибка вторая: забыть npm install после скачивания проекта

Ошибка третья: угадывать команду запуска. Команды нужно смотреть в scripts

Ошибка четвертая: путать npm install и npm run. Первая команда ставит зависимости, вторая запускает сценарии проекта

Ошибка пятая: запускать dev-сервер как постоянный продакшен-сервер. Для публикации нужен отдельный сценарий и настройка окружения

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

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

0 комментариев

Старые

Новые Популярные