Команды, файлы и конфигурация

Команда поступает в терминал

Терминал — это окно, в котором вы вводите инструкции для своего компьютера. В Visual Studio Code сначала откройте папку supastack, используя «Файл» → «Открыть папку», затем выберите «Терминал» → «Новый терминал». Новый терминал запускается в этой папке. В Windows выберите PowerShell, используя меню рядом с кнопкой + на терминале. Используйте блоки macOS/Linux в терминале macOS или Linux.

Вставляйте только содержимое командного блока, по одной команде за раз, и нажмите Enter. Не вставляйте окружающие обратные кавычки Markdown, приглашение, такое как PS C:\..., или пример вывода. Строки, начинающиеся с #, являются пояснениями; они ничего не запускают. Дождитесь завершения каждой команды установки, прежде чем вводить следующую команду. Серверная команда продолжает выполняться и не возвращает новое приглашение, пока вы ее не остановите.

Проверьте, какую папку использует терминал

Корень репозитория означает папку supastack верхнего уровня, содержащую package.json, pnpm-workspace.yaml, приложения и пакеты. Если в шаге не указано иное, запускайте команды там. Команда ниже печатает текущую папку; в списке файлов должен быть указан package.json. В Windows также работают PowerShell pwd и ls.

Если список показывает только содержимое apps/mobile, введите cd ../.. и нажмите Enter, чтобы вернуться в корень. Если показана домашняя папка, введите cd, затем пробел и полный путь к вашему клону, в кавычках, если в нём есть пробелы. Обычно проще открыть папку проекта в редакторе и создать новый терминал.

pwd
ls

Конфигурация хранится в файле, а не в терминале

Блок типа AI_PROVIDER=fake представляет собой текст конфигурации. Откройте указанный файл .env в редакторе, найдите строку, начинающуюся с AI_PROVIDER=, замените ее значение и сохраните с помощью Ctrl + S (Command + S в macOS). Каждая настройка занимает одну строку в формате KEY=value. Не добавляйте обратные кавычки Markdown. Избегайте дублирования копий одного и того же ключа в одном файле.

Используйте apps/mobile/.env.local для Expo и корневой .env для команд миграции базы данных. Expo не загружает корневой .env автоматически. Web-бэкенд читает собственный apps/web/.env.local; в checkout только Mobile этот файл принадлежит отдельному репозиторию бэкенда, а не этому. Если адрес бэкенда меняется, обновите EXPO_PUBLIC_API_URL в apps/mobile/.env.local и перезапустите Expo. Храните файл-пример без изменений для справки.

Файлы, имена которых начинаются с точки, могут быть скрыты в вашем файловом менеджере; Проводник редактора показывает их. Убедитесь, что имя файла именно .env.local, а не .env.local.txt. Эти локальные файлы могут содержать пароли и исключены из Git; не загружайте их и не вставляйте их содержимое в сообщения поддержки.

• Найдите значение каждой настройки

Поддерживайте работу сервера; используйте другой терминал для команд

Сервер разработки Expo доставляет ваши экраны на телефон или симулятор во время работы. Держите его терминал открытым, когда учебное пособие просит отсканировать QR-код. Серверная команда продолжает работать и не возвращает новое приглашение, пока вы её не остановите.

Чтобы запустить другую команду, пока сервер активен, выберите «Терминал» → «Новый терминал» в редакторе. Новый терминал — это отдельное окно в тот же проект. Чтобы остановить сервер, выберите его терминал и нажмите Ctrl + C один раз. В Windows, если вас спросят «Завершить пакетное задание», введите Y и нажмите Enter. Дождитесь обычного запроса, прежде чем запускать его снова.

После редактирования настроек Expo остановите его Ctrl + C, затем выполните команду ниже, чтобы перезапустить и очистить кэшированный бандл. Сохранение исходного файла обычно обновляет предпросмотр автоматически, но изменения окружения требуют перезапуска.

corepack pnpm --filter @supastack/mobile start --clear

Прочтите неудачу и попросите полезную помощь

Если при установке возвращается красный текст ошибки, остановитесь на этом шаге. Прочитайте первую ошибку, а не продолжайте запускать приложение. Команда не найдена обычно означает отсутствие инструмента; отсутствие package.json обычно означает неправильную папку; ECONNREFUSED обычно означает, что необходимый сервер или база данных не работает; EADDRINUSE означает, что другой процесс уже использует этот порт.

При обращении за помощью укажите свою операционную систему, руководство URL и номер шага, точную введенную команду и первое сообщение об ошибке. Удалите пароли, ключи API, токены и часть пароля из любой базы данных URL. Не отправляйте файлы .env. Скриншот ошибки может помочь, но копируемый текст легче диагностировать.

• Устранение конкретной ошибки установки