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

Сборка из чистой копии

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

Проверим, что каталог запускается без переноса папки node_modules и что результат сборки можно открыть отдельно.

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

Для повторяемой установки сохраните package.json и package-lock.json в Git, а node_modules/ и dist/ внесите в .gitignore. Затем клонируйте каталог в новую папку без установленных пакетов. npm ci читает lock-файл, устанавливает зависимости и завершится ошибкой, если package.json с ним не согласован. После npm run build Vite создаёт dist с итоговым index.html и ресурсами; npm run preview показывает эту сборку локально. Preview служит проверкой результата, а не размещением сайта для пользователей.

Работайте из родительской папки: тогда git clone ./catalog-build catalog-check создаст соседнюю чистую копию. Если catalog-build ещё не репозиторий, примените знакомые git init, git add, git diff —cached и git commit из блока Git. Перед клонированием убедитесь, что package-lock.json попал в коммит. Не копируйте node_modules вручную: так скрываются пропущенные зависимости и проблемы версии.

npm ci не редактирует package.json и package-lock.json. Если они расходятся, исправьте исходный catalog-build командой npm install, проверьте изменение обоих файлов, сохраните новый коммит и создайте свежую проверочную копию. dist — результат сборки, а не исходник. Preview открывает собранный вариант локально; при публикации нужны отдельные настройки хостинга, которые этот урок не выполняет.

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

Чистая копия
Клон репозитория без локальных установленных пакетов и сгенерированной сборки.
npm ci
Установка по существующему lock-файлу с проверкой его согласованности с package.json.
dist
Папка результата сборки Vite с HTML и ресурсами для размещения.
Preview
Локальный просмотр уже собранного результата.
Путь от исходников к проверенной сборке
  1. Git-копияИсходники, package.json и package-lock.json
  2. npm ciВосстанавливает node_modules по lock-файлу
  3. npm run buildСоздаёт dist из исходников
  4. npm run previewПоказывает готовую сборку локально

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

git clone ./catalog-build catalog-check
cd catalog-check
npm ci
npm run build
npm run preview

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

  • Кодовый блок содержит только команды терминала; JSON предыдущего урока хранится в package.json.
  • Команды git clone и cd выполняются из родительской папки catalog-build.
  • Если npm ci проходит, но в dist нет нужной страницы, проверяйте index.html и пути к CSS/JS, а не копируйте файлы в dist вручную.

Практика

  1. В catalog-build выполните git init, если это ещё не репозиторий. Добавьте node_modules/ и dist/ в .gitignore. Проверьте git status и подготовленный diff; сохраните в коммите index.html, css, js, images при наличии, package.json, package-lock.json и .gitignore, но не node_modules и dist.
  2. Откройте терминал в родительской папке catalog-build и выполните команды из примера по порядку. В PowerShell при блокировке npm.ps1 замените каждое npm на npm.cmd. Клонированная catalog-check должна сначала не иметь node_modules; npm ci установит их по lock-файлу.
  3. После сборки найдите dist/index.html и откройте адрес, показанный npm run preview. Проверьте текст, CSS и работу JS. Остановите preview Ctrl+C; в README запишите версии Node/npm и команды npm ci, npm run build и npm run preview.

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

Новая копия без node_modules проходит npm ci и npm run build, создаёт dist и показывает рабочую страницу через preview; исходные файлы и lock-файл остаются в Git.

Если не получилось
  • npm ci требует package-lock.json? Вернитесь в исходный catalog-build, выполните npm install, закоммитьте созданный lock-файл и снова сделайте чистый клон.
  • npm ci сообщает о несогласованности package.json и lock-файла? Обновите lock через npm install в исходной папке и сохраните оба файла вместе; не исправляйте lock вручную в проверочной копии.
  • git clone сообщает, что catalog-check уже существует? Выберите другое имя для новой пустой папки и повторите проверку, не затирая прежние файлы.

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