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
- Локальный сервер разработки и инструмент сборки статического интерфейса.
| Файл или папка | Действие |
|---|---|
| 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-сервера берите из вывода терминала: при занятом стандартном порту он может выбрать другой.
Практика
- Создайте package.json в корне catalog-build и вставьте только JSON из примера. Сохраните его как UTF-8. В index.html проверьте ссылки на css/style.css и js/app.js; для JS укажите script type="module", поскольку Vite собирает модульный вход.
- В терминале этой папки выполните npm install -D vite (в PowerShell при блокировке npm.ps1 — npm.cmd install -D vite). Найдите добавленную devDependencies в package.json, новый package-lock.json и папку node_modules.
- Выполните 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.
Куда заглянуть дальше
Чтобы сохранять прогресс, войдите или зарегистрируйтесь.
Следующий материал ↗