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

package.json, зависимость и команды

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

Опишем локальные команды каталога в одном JSON-файле и установим инструмент разработки как зависимость проекта.

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

Файл package.json описывает имя проекта и scripts. Команда npm install -D vite добавляет Vite в devDependencies, создаёт package-lock.json и устанавливает файлы в node_modules. Vite читает index.html из корня catalog-build, запускает локальный сервер командой npm run dev и позднее собирает статические файлы командой npm run build. Пакет ставится локально: другой ученик получит его по package.json и lock-файлу, а не через вашу папку node_modules. JSON не допускает комментариев и лишней запятой после последнего поля.

Редактируйте package.json как JSON-файл, а команды npm выполняйте в терминале: это разные виды текста. В примере нет devDependencies, потому что npm добавит её после установки Vite. Не вставляйте в JSON команды npm или комментарии. Папка node_modules содержит установленные копии пакетов; её не нужно переносить между компьютерами.

Vite использует index.html как вход проекта. Ссылка на CSS остаётся обычным link, а JS подключается через script type="module" с путём к js/app.js. После перехода на модульный скрипт проверяйте страницу через адрес, напечатанный dev-сервером, а не двойным щелчком по file://. Локальный сервер нужен только для разработки; браузерный результат проверяем отдельно.

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

package.json
JSON-манифест с именем проекта, зависимостями и именованными командами scripts.
devDependencies
Пакеты, нужные для разработки и сборки, но не загружаемые браузером как готовый сайт.
package-lock.json
Созданный npm снимок точного дерева зависимостей для повторяемой установки.
node_modules
Локальная папка установленных пакетов, восстанавливаемая командой npm.
Vite
Локальный сервер разработки и инструмент сборки статического интерфейса.
Что хранить в истории Git
Файл или папка Действие
package.json Сохранить: команды и прямые зависимости
package-lock.json Сохранить: точное дерево зависимостей
node_modules/ Игнорировать: восстанавливается установкой
dist/ Игнорировать: создаётся сборкой

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

{
  "name": "catalog-build",
  "version": "1.0.0",
  "private": true,
  "scripts": {
    "dev": "vite",
    "build": "vite build",
    "preview": "vite preview"
  }
}

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

  • Кодовый блок — только содержимое package.json; команды установки и запуска находятся в шагах практики.
  • npm run dev вызывает локальный Vite из node_modules/.bin; глобальная установка не требуется.
  • Адрес и порт dev-сервера берите из вывода терминала: при занятом стандартном порту он может выбрать другой.

Практика

  1. Создайте package.json в корне catalog-build и вставьте только JSON из примера. Сохраните его как UTF-8. В index.html проверьте ссылки на css/style.css и js/app.js; для JS укажите script type="module", поскольку Vite собирает модульный вход.
  2. В терминале этой папки выполните npm install -D vite (в PowerShell при блокировке npm.ps1 — npm.cmd install -D vite). Найдите добавленную devDependencies в package.json, новый package-lock.json и папку node_modules.
  3. Выполните npm run dev или npm.cmd run dev. Откройте адрес, который напечатал Vite, и проверьте заголовок, стиль и сообщение из js/app.js в консоли браузера. Остановите сервер Ctrl+C.

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

Каталог открывается по локальному адресу Vite; package.json содержит scripts и Vite в devDependencies, а package-lock.json записал дерево пакетов.

Если не получилось
  • npm сообщает об ошибке JSON? Проверьте двойные кавычки, запятые и отсутствие комментариев в package.json.
  • Vite сообщает о неподдерживаемой версии Node? Сверьте требования актуальной документации Vite и обновите Node LTS, затем повторите установку.
  • npm run dev не находит script? Проверьте, что терминал находится в catalog-build и package.json содержит scripts.dev.

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