Сборка из чистой копии
Проверим, что каталог запускается без переноса папки 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
- Локальный просмотр уже собранного результата.
- Git-копияИсходники, package.json и package-lock.json
- npm ciВосстанавливает node_modules по lock-файлу
- npm run buildСоздаёт dist из исходников
- 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 вручную.
Практика
- В 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.
- Откройте терминал в родительской папке catalog-build и выполните команды из примера по порядку. В PowerShell при блокировке npm.ps1 замените каждое npm на npm.cmd. Клонированная catalog-check должна сначала не иметь node_modules; npm ci установит их по lock-файлу.
- После сборки найдите 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 уже существует? Выберите другое имя для новой пустой папки и повторите проверку, не затирая прежние файлы.
Куда заглянуть дальше
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗