< Все записки
Разработка

Подготовка Astro-проекта к переносу

20 апреля 2026 г. Оператор #astro#frontend#npm#workflow

Для переноса проекта на Astro на другой компьютер или подготовке его к отправке в репозиторий, первым делом стоит навести в нём порядок. Удаление временных папок не только экономит место, но и помогает избежать конфликтов из-за разницы в системных окружениях. Это обеспечит быструю и корректную настройку проекта на новом рабочем месте.

Директории для удаления

Перед переносом или архивацией удалите следующие папки:

  • node_modules/ — зависимости проекта (переустанавливаются на новом месте).

  • dist/ — результат сборки (генерируется заново).

  • .astro/ — локальный кэш и типы (создаются автоматически при запуске).

Быстрая очистка (терминал)

rm -rf node_modules dist .astro

Настройка .gitignore

Убедитесь, что временные файлы не попадают в Git:

node_modules/
dist/
.astro/
*-debug.log*

Развертывание на новом месте

  1. Скопируйте исходный код.

  2. Установите зависимости: npm install (или pnpm i / yarn).

  3. Запустите проект: npm run dev или создайте сборку npm run build.

Примечания

  • Lock-файлы: Никогда не удаляйте package-lock.json, pnpm-lock.yaml или yarn.lock. Они гарантируют установку идентичных версий библиотек на всех устройствах.

  • Версия Node.js: Используйте файл .nvmrc в корне проекта, чтобы зафиксировать версию Node.js. Внутри него достаточно просто указать номер версии (например, 20 или v20.11.0). Это позволит менеджеру версий (например, nvm) автоматически переключаться на нужное окружение командой nvm use, предотвращая ошибки совместимости.