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/ru/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. Ноутбуки работают медленно

Описание: Некоторые задачи ИИ требуют значительных ресурсов памяти и процессора.

Симптомы:

  • Медленное выполнение
  • Шум вентилятора ноутбука

Возможные причины:

  • Большие наборы данных или модели
  • Ограниченные ресурсы системы

Решения:

  1. Используйте облачную платформу.
    • Загрузите ноутбук в Colab или Azure Notebooks.
  2. Уменьшите размер набора данных.
    • Используйте образцы данных для практики.
  3. Закройте ненужные программы.
    • Освободите оперативную память системы.

Проблемы с веб-сайтом учебника

9. Глава не загружается

Описание: Онлайн-учебник отображает уроки и главы.

Симптомы:

  • Глава (например, Transformers/BERT) отсутствует или не открывается

Известная проблема:

  • Issue #303: «18 Transformers. BERT. не открывается на сайте учебника». Причина — ошибка в названии файла (READMEtransformers.md вместо README.md).

Решения:

  1. Проверьте ошибки в названии файлов.
    Если вы являетесь участником, убедитесь, что файлы глав названы README.md.
  2. Сообщите о пропущенных файлах.
    Откройте проблему на GitHub с названием главы и подробностями ошибки.

Проблемы с внесением вклада

10. PR не принят или сборки не проходят

Описание: Внесенные изменения должны проходить тесты и соответствовать требованиям.

Симптомы:

  • Pull request отклонен
  • Ошибки в CI/CD пайплайне

Возможные причины:

  • Неудачные тесты
  • Несоблюдение стандартов кодирования

Решения:

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

Часто задаваемые вопросы

Где я могу найти помощь по конкретным модулям?

  • У каждого модуля обычно есть свой README. Начните с него для получения советов по настройке и использованию.

Как сообщить об ошибке или запросить новую функцию?

Могу ли я попросить помощи, если моя проблема не указана?

  • Да! Сначала выполните поиск среди существующих проблем, и если вы не найдете свою, создайте новую.

Получение помощи

  • Проверьте проблемы: GitHub Issues
  • Задавайте вопросы: Используйте GitHub Discussions или откройте проблему.
  • Сообщество: Смотрите ссылки репозитория для чатов/форумов.

Последнее обновление: 20 сентября 2025 года

Отказ от ответственности:
Этот документ был переведен с использованием сервиса автоматического перевода Co-op Translator. Несмотря на наши усилия обеспечить точность, автоматические переводы могут содержать ошибки или неточности. Оригинальный документ на его родном языке следует считать авторитетным источником. Для получения критически важной информации рекомендуется профессиональный перевод человеком. Мы не несем ответственности за любые недоразумения или неправильные интерпретации, возникшие в результате использования данного перевода.