For AI agents: fetch the complete documentation index at /llms.txt, the full documentation corpus at /llms-full.txt, the agent skill at /skill.md, or this page as Markdown at /ru/docs/web/terminal-basics.md (or send Accept: text/markdown).
Команды, файлы и конфигурация
Узнайте, куда вставлять команды, как открыть правильную папку проекта, редактировать файлы .env, останавливать сервер и сообщать об ошибке установки, не раскрывая секретов.
Команда поступает в терминал
Терминал — это окно, в котором вы вводите инструкции для своего компьютера. В 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/web или apps/mobile, введите cd ../.. и нажмите Enter, чтобы вернуться в корень. Если отображается ваша домашняя папка, введите cd, затем пробел и полный путь к вашему клону, заключенный в кавычки, если он содержит пробелы. Открыть папку проекта в редакторе и создать новый терминал обычно проще.
pwd
lsКонфигурация хранится в файле, а не в терминале
Блок типа AI_PROVIDER=fake представляет собой текст конфигурации. Откройте указанный файл .env в редакторе, найдите строку, начинающуюся с AI_PROVIDER=, замените ее значение и сохраните с помощью Ctrl + S (Command + S в macOS). Каждая настройка занимает одну строку в формате KEY=value. Не добавляйте обратные кавычки Markdown. Избегайте дублирования копий одного и того же ключа в одном файле.
Используйте корневой .env для команд миграции базы данных, apps/web/.env.local для веб-сервера Next.js и apps/mobile/.env.local для Expo. Next и Expo запускаются внутри собственных папок приложений и не загружают автоматически корневой .env. Если подключение к базе данных изменится, обновите DATABASE_URL как в корневом файле .env, так и в apps/web/.env.local, чтобы при миграции и на сервере использовалась одна и та же база данных. Сохраните файл примера без изменений для дальнейшего использования.
Файлы, имена которых начинаются с точки, могут быть скрыты в вашем файловом менеджере; Проводник редактора показывает их. Убедитесь, что имя файла именно .env.local, а не .env.local.txt. Эти локальные файлы могут содержать пароли и исключены из Git; не загружайте их и не вставляйте их содержимое в сообщения поддержки.
Поддерживайте работу сервера; используйте другой терминал для команд
Сервер разработки обслуживает ваше приложение, пока вы работаете. Оставьте его терминал открытым, когда в руководстве написано «Открыть localhost:3000». localhost означает этот компьютер; :3000 — это порт, аналогичный номеру двери, используемый приложением. Поместите URL в адресную строку браузера, а не в терминал.
Чтобы запустить другую команду, пока сервер активен, выберите «Терминал» → «Новый терминал» в редакторе. Новый терминал — это отдельное окно в тот же проект. Чтобы остановить сервер, выберите его терминал и нажмите Ctrl + C один раз. В Windows, если вас спросят «Завершить пакетное задание», введите Y и нажмите Enter. Дождитесь обычного запроса, прежде чем запускать его снова.
После редактирования настроек веб-среды остановите и перезапустите веб-сервер с помощью приведенной ниже команды. При сохранении исходного файла страница обычно обновляется автоматически, но при изменении среды требуется перезагрузка. После редактирования настроек Expo остановите Expo, затем запустите corepack pnpm --filter @supastack/mobile start --clear, чтобы перезапустить и очистить кэшированный пакет.
corepack pnpm --filter @supastack/web devПрочтите неудачу и попросите полезную помощь
Если при установке возвращается красный текст ошибки, остановитесь на этом шаге. Прочитайте первую ошибку, а не продолжайте запускать приложение. Команда не найдена обычно означает отсутствие инструмента; отсутствие package.json обычно означает неправильную папку; ECONNREFUSED обычно означает, что необходимый сервер или база данных не работает; EADDRINUSE означает, что другой процесс уже использует этот порт.
При обращении за помощью укажите свою операционную систему, руководство URL и номер шага, точную введенную команду и первое сообщение об ошибке. Удалите пароли, ключи API, токены и часть пароля из любой базы данных URL. Не отправляйте файлы .env. Скриншот ошибки может помочь, но копируемый текст легче диагностировать.