6.1 KiB
Якщо ви зіткнулися з проблемою, найімовірніше, у цій документації написано її вирішення.
Проблеми з встановленням рекомендованих попередніх умов
Ми регулярно використовуємо найновіші та найпопулярніші операційні системи, як-от macOS 10.15 і вище, Ubuntu 18.04 і вище та Windows 10 (із WSL2).
Рекомендовано шукати розв’язок певної проблеми у Google, Stack Overflow та Stack Exchange. Ймовірно, хтось вже стикався із тією ж проблемою і на ваш запит вже є відповідь.
Якщо ви використовуєте іншу ОС або досі стикаєтесь із проблемами, див. отримання допомоги.
Warning
Будь ласка, уникайте створення проблем на GitHub щодо попередніх умов. Вони не входять у межі проєкту.
Проблеми відсутніх UI, шрифтів, мовних рядків чи помилки збірки
Коли ви будуєте клієнта, Gatsby кешує шрифти, мовні рядки та UI. Якщо щось з переліченого не кешоване, виконайте наступне:
pnpm run clean
pnpm install
pnpm run seed
pnpm run develop
АБО
Скористайтеся скороченням
pnpm run clean-and-develop
Якщо ви надалі стикаєтесь з помилками збірки, рекомендовано очистити робоче середовище.
Використайте git clean в інтерактивному режимі:
git clean -ifdX
Як очистити файли git, які не відстежуються (знімок екрану)
Проблеми з API, входом, здачею завдань тощо
Якщо ви не можете увійти, а замість цього бачите банер з повідомленням про помилку, яка буде відправлена до freeCodeCamp, будь ласка, перевірте, чи не використовується ваш локальний порт 3000 іншою програмою.
З термінала:
netstat -a | grep "3000"
tcp4 0 0 0.0.0.0:3000 DESKTOP LISTEN
Проблеми з виходом під час перегляду
Ваш сеанс зберігається як файли cookies під час розробки. Якщо їх видалити, ви вийдете з облікового запису розробки.
Якщо запустити pnpm run seed:certified-user, ви також вийдете з облікового запису. Це замінить користувача розробки у вашій локальній базі даних.
Проблема отримання 404 під час перегляду облікового запису
Коли ви намагаєтесь перейти до http://localhost:8000/developmentuser, щоб переглянути обліковий запис, Gatsby піклується про обслуговування сторінок на стороні клієнта, тому під час роботи ви отримаєте сторінку з помилкою 404.
Натисніть на кнопку «Preview Custom 404 Page», щоб переглянути обліковий запис.
Проблеми при встановленні залежностей
Якщо при встановленні залежностей виникають помилки, переконайтеся, що ви не перебуваєте в мережі з обмеженнями або налаштування мережевого екрана не перешкоджають доступу до ресурсів.
Перше налаштування може зайняти деякий час (залежно від пропускної здатності вашої мережі). Будьте терплячими. Якщо ви досі не знайшли рішення, ми рекомендуємо використати Gitpod замість автономної роботи.
[!NOTE] Якщо ви використовуєте пристрої Apple із чипом M1 для локального запуску застосунку, рекомендовано використовувати Node v14.7 і вище. В іншому випадку ви можете натрапити на проблеми із залежностями, як-от Sharp.
Робота з іншими мовами
Щоб переглянути роботу клієнта іншою мовою, перейдіть до тестування клієнтського застосунку за мовою.
Отримання допомоги
Якщо вам потрібна допомога, не соромтесь ставити питання на нашому форумі у розділі «Contributors» або у чаті.
У консолі вашого браузера або в Bash / терміналі / командному рядку може з’явитися помилка, яка допоможе визначити проблему. Поділіться цим повідомленням про помилку в описі проблеми, щоб іншим було легше визначити проблему і знайти рішення.