УРОК · Node и npm: запуск и сборка

Node, npm и терминал проекта

Опубликовано Автор: Соловьёва Мария Андреевна

Браузер уже выполнял наш JavaScript. Теперь проверим Node и npm в терминале, прежде чем устанавливать инструмент сборки.

Разберём по шагам

Node.js выполняет JavaScript вне браузера, а npm помогает устанавливать пакеты и запускать команды проекта. Сам браузер не получает Node.js: после сборки он загружает обычные HTML, CSS и JavaScript. Возьмите копию знакомого статического catalog в отдельной папке catalog-build, чтобы не менять исходный учебный пример или PHP-проект notes-php. Для следующих шагов нужны index.html, css/style.css и js/app.js. Проверьте установленную версию Node и npm; если команд нет, установите актуальную LTS-версию Node.js с официального сайта и откройте терминал заново.

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

В Windows PowerShell команда npm иногда выбирает npm.ps1, который блокируется политикой выполнения скриптов. В таком случае выполните npm.cmd —version и далее используйте npm.cmd вместо npm в командах этого блока либо откройте Command Prompt. Не меняйте системную политику выполнения только ради упражнения. В macOS и Linux остаётся обычная команда npm.

Слова, которые пригодятся

Node.js
Среда выполнения JavaScript вне браузера; здесь она запускает инструмент разработки.
npm
Менеджер пакетов и команд проекта, устанавливаемый вместе с Node.js.
LTS
Линия Node.js с длительной поддержкой; её выбирают для предсказуемой учебной среды.
Терминал проекта
Окно команд, открытое в нужной папке; текущая папка влияет на работу npm.
Где выполняется JavaScript
Среда Что делает в нашем каталоге
Браузер Выполняет js/app.js после открытия страницы
Node.js Запускает команды инструмента сборки в терминале
npm Ставит локальные пакеты и вызывает scripts из package.json

Рабочий пример

node --version
npm --version
node -e "console.log('Node работает')"

Что здесь происходит

  • Команды из примера вводятся в терминале по одной; это не содержимое файла проекта.
  • node -e выполняет короткий JavaScript в терминале и не изменяет index.html.
  • В следующих уроках npm устанавливает пакет только в catalog-build.

Практика

  1. Создайте рядом с прежним catalog отдельную папку catalog-build и скопируйте туда index.html, css/style.css и js/app.js. Если двух последних файлов пока нет, создайте их и добавьте в js/app.js одну строку console.log с понятным сообщением.
  2. Откройте терминал в catalog-build и выполните команды из примера. Если Node или npm не найдены, установите текущую LTS-версию Node.js и повторите проверку в новом терминале. Сверьте свою версию с требованиями актуальной документации Vite.
  3. Запишите версии Node и npm в README каталога. Объясните, какая программа выполняет код в терминале, а какая показывает готовую страницу.

Как проверить себя

Команды показывают версии Node и npm и сообщение «Node работает»; в catalog-build лежит копия статического проекта, а исходный каталог не изменён.

Если не получилось
  • node не найден? Установите Node.js с официального сайта, закройте старый терминал и откройте новый; снова выполните node —version.
  • PowerShell сообщает, что npm.ps1 запрещён? Попробуйте npm.cmd —version и используйте npm.cmd в следующих командах, не меняя политику выполнения.
  • Терминал открыт в notes-php или старом catalog? Проверьте текущую папку в приглашении и откройте именно catalog-build.

Куда заглянуть дальше