RomanNum3ral
/
AI-For-Beginners
mirror of https://github.com/microsoft/AI-For-Beginners.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
AI-For-Beginners/translations/uk/troubleshoot.md

13 KiB
Raw Blame History

Посібник з усунення несправностей AI-For-Beginners

Цей посібник допоможе вам вирішити поширені проблеми, які виникають під час використання або внесення змін до репозиторію AI-For-Beginners. Кожна проблема містить опис, симптоми, пояснення та покрокові рішення.

Зміст

Загальні проблеми

1. Репозиторій не клонується належним чином

Опис: Клонування дозволяє скопіювати репозиторій на ваш комп'ютер.

Симптоми:

  • Помилка: fatal: repository not found
  • Помилка: Permission denied (publickey)

Можливі причини:

  • Неправильна URL-адреса репозиторію
  • Недостатньо прав доступу
  • SSH-ключі не налаштовані

Рішення:

  1. Перевірте URL-адресу репозиторію.
    Використовуйте HTTPS URL: 
    git clone https://github.com/microsoft/AI-For-Beginners.git
  2. Перейдіть на HTTPS, якщо SSH не працює.
    Якщо ви бачите Permission denied (publickey), використовуйте HTTPS-лінк замість SSH.
  3. Налаштуйте SSH-ключі (опціонально).
    Якщо ви хочете використовувати SSH, дотримуйтесь інструкції GitHub щодо SSH.

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

2. Проблеми з Python-середовищем

Опис: Репозиторій залежить від Python та різних бібліотек.

Симптоми:

  • Помилка: ModuleNotFoundError: No module named '<package>'
  • Помилки імпорту під час запуску скриптів або ноутбуків

Можливі причини:

  • Залежності не встановлені
  • Неправильна версія Python

Рішення:

  1. Налаштуйте віртуальне середовище. 
    python -m venv venv
source venv/bin/activate   # On Windows: venv\Scripts\activate
  2. Встановіть залежності. 
    pip install -r requirements.txt
  3. Перевірте версію Python.
    Використовуйте Python 3.7 або новішу. 
    python --version

3. Jupyter не встановлено

Опис: Ноутбуки є основним навчальним ресурсом.

Симптоми:

  • Помилка: jupyter: command not found
  • Ноутбуки не запускаються

Можливі причини:

  • Jupyter не встановлено

Рішення:

  1. Встановіть Jupyter Notebook. 
    pip install notebook
    або, якщо ви використовуєте Anaconda: 
    conda install notebook
  2. Запустіть Jupyter Notebook. 
    jupyter notebook

4. Конфлікти версій залежностей

Опис: Проекти можуть не працювати, якщо версії пакетів не співпадають.

Симптоми:

  • Помилки або попередження про несумісні версії

Можливі причини:

  • Старі або конфліктуючі Python-пакети

Рішення:

  1. Встановіть у чистому середовищі.
    Видаліть старе venv/conda середовище та створіть нове.
  2. Використовуйте точні версії.
    Завжди виконуйте: 
    pip install -r requirements.txt
    Якщо це не працює, вручну встановіть відсутні пакети, як описано в README.

Проблеми з конфігурацією

5. Змінні середовища не налаштовані

Опис: Деякі модулі можуть вимагати ключі, токени або налаштування конфігурації.

Симптоми:

  • Помилка: KeyError або попередження про відсутність конфігурації

Можливі причини:

  • Не налаштовані необхідні змінні середовища

Рішення:

  1. Перевірте наявність файлів .env.example або подібних.
  2. Створіть файл .env і заповніть необхідні значення.
  3. Перезавантажте термінал або IDE після налаштування змінних середовища.

Запуск ноутбуків

6. Ноутбук не відкривається або не запускається

Опис: Для роботи Jupyter ноутбуків потрібна правильна конфігурація.

Симптоми:

  • Ноутбук не запускається
  • Браузер не відкривається автоматично

Можливі причини:

  • Jupyter не встановлено
  • Проблеми з конфігурацією браузера

Рішення:

  1. Встановіть Jupyter (див. Проблеми з установкою вище).
  2. Відкрийте ноутбуки вручну.
    • Скопіюйте URL з терміналу (наприклад, http://localhost:8888/?token=...) і вставте його у браузер.

7. Ядро зависає або аварійно завершує роботу

Опис: Ядра ноутбуків можуть аварійно завершувати роботу через обмеження ресурсів або помилки в коді.

Симптоми:

  • Ядро постійно завершує роботу або перезапускається
  • Помилки через недостатню пам'ять

Можливі причини:

  • Великі набори даних
  • Несумісний код або пакети

Рішення:

  1. Перезапустіть ядро.
    Використовуйте кнопку "Restart Kernel" у Jupyter.
  2. Перевірте використання пам'яті.
    Закрийте непотрібні програми.
  3. Запускайте ноутбуки на хмарних платформах.
    Використовуйте Google Colab або Azure Notebooks.

Проблеми з продуктивністю

8. Ноутбуки працюють повільно

Опис: Деякі завдання AI вимагають значних ресурсів пам'яті та процесора.

Симптоми:

  • Повільне виконання
  • Гучний шум вентилятора ноутбука

Можливі причини:

  • Великі набори даних або моделі
  • Обмежені ресурси системи

Рішення:

  1. Використовуйте хмарну платформу.
    • Завантажте ноутбук у Colab або Azure Notebooks.
  2. Зменшіть розмір набору даних.
    • Використовуйте зразкові дані для практики.
  3. Закрийте непотрібні програми.
    • Звільніть оперативну пам'ять системи.

Проблеми з вебсайтом підручника

9. Розділ не завантажується

Опис: Онлайн-підручник відображає уроки та розділи.

Симптоми:

  • Розділ (наприклад, Transformers/BERT) відсутній або не відкривається

Відома проблема:

  • Issue #303: “18 Transformers. BERT. не відкривається на вебсайті підручника.” Причина — помилка у назві файлу (READMEtransformers.md замість README.md).

Рішення:

  1. Перевірте помилки в назві файлів.
    Якщо ви є контриб'ютором, переконайтеся, що файли розділів названі README.md.
  2. Повідомте про відсутні файли.
    Створіть GitHub issue із назвою розділу та деталями помилки.

Проблеми з внесенням змін

10. PR не прийнято або збірки не проходять

Опис: Внески повинні проходити тести та відповідати вимогам.

Симптоми:

  • Pull request відхилено
  • Помилки в CI/CD пайплайні

Можливі причини:

  • Невдалі тести
  • Недотримання стандартів кодування

Рішення:

  1. Прочитайте інструкції для контриб'юторів.
  2. Запустіть тести локально перед відправкою.
  3. Перевірте правила linting або вимоги до форматування.

Часті запитання

Де я можу знайти допомогу для конкретних модулів?

  • Кожен модуль зазвичай має свій README. Почніть з нього для налаштування та порад щодо використання.

Як повідомити про помилку або запропонувати функцію?

Чи можу я попросити допомогу, якщо моєї проблеми немає в списку?

  • Так! Спочатку знайдіть існуючі issues, і якщо ви не знайдете своєї проблеми, створіть нове issue.

Отримання допомоги

  • Перевірте Issues: GitHub Issues
  • Задавайте питання: Використовуйте GitHub Discussions або створіть issue.
  • Спільнота: Дивіться посилання репозиторію для чату/форуму.

Останнє оновлення: 2025-09-20

Відмова від відповідальності:
Цей документ був перекладений за допомогою сервісу автоматичного перекладу Co-op Translator. Хоча ми прагнемо до точності, будь ласка, майте на увазі, що автоматичні переклади можуть містити помилки або неточності. Оригінальний документ на його рідній мові слід вважати авторитетним джерелом. Для критичної інформації рекомендується професійний людський переклад. Ми не несемо відповідальності за будь-які непорозуміння або неправильні тлумачення, що виникають внаслідок використання цього перекладу.