Troubleshooting — Ступень 0: Основы
База знаний типичных ошибок курса Ступень 0: Основы.
Категория
Симптомы
- Не понимаешь, что вообще запускать. На рабочем столе нет иконки 'Терминал'. Не ясно, чем терминал отличается от обычной командной строки Windows.
Причина
Терминал не вынесен на видное место -- его надо найти через поиск На Windows ты ищешь 'терминал', а в курсе нужен Linux-терминал внутри WSL2 Перепутал терминал с чем-то другим (браузером, проводником)
Решение
- macOS: нажми Cmd+Space, набери 'Terminal', нажми Enter -- откроется чёрное окно
- Windows: установи WSL2 (см. проблему wsl-install-failed), затем открой Windows Terminal и выбери профиль Ubuntu
- Linux: ищи в приложениях 'Terminal', 'Konsole' или 'GNOME Terminal'; часто работает сочетание Ctrl+Alt+T
- Закрепи терминал в Dock/панели задач, чтобы потом находить быстро
Связанные уроки:
Симптомы
- Набираешь python или python3, жмёшь Enter, и видишь 'command not found' или 'python is not recognized'.
Причина
Python ещё не установлен на компьютере Python установлен, но его папки нет в PATH На macOS/Linux команда называется python3, а не python Опечатка в имени команды
Решение
- Сначала попробуй python3 вместо python -- на macOS и Linux чаще работает именно он
- Если ничего не находится, поставь Python: macOS -- brew install python; Ubuntu/WSL2 -- sudo apt update && sudo apt install python3
- После установки закрой и открой терминал заново, чтобы он подхватил новый PATH
- На Windows используй WSL2 и ставь Python там же командой apt -- так примеры курса совпадут
Симптомы
- В одной инструкции пишут python, в другой python3, и непонятно, что набирать. Команда python выдаёт ошибку, а python3 -- работает.
Причина
Исторически python означал старый Python 2, поэтому на macOS/Linux нынешний Python зовут python3 В разных системах и инструкциях используют разные имена На Windows внутри WSL2 тоже обычно python3
Решение
- Запомни простое правило: на macOS, Linux и в WSL2 почти всегда работает python3
- Если в инструкции написано python, а у тебя ошибка -- мысленно добавляй тройку: python3
- То же с pip: используй pip3, если pip не находится
- Не пытайся 'починить' это удалением -- просто пиши python3
Симптомы
- Команда отвечает 'permission denied' или 'Permission denied'. Файл не создаётся, программа не запускается, установка обрывается.
Причина
Пытаешься записать или изменить файл в системной папке, где у тебя нет прав Запускаемый файл не помечен как исполняемый Установка программы требует прав администратора
Решение
- Работай в своей домашней папке (cd ~) -- там права у тебя есть
- Если файл нужно запустить: chmod +x имя_файла, затем ./имя_файла
- Если это установка программы -- добавь sudo в начало: sudo apt install ... (введи пароль вслепую)
- Не лепи sudo ко всему подряд -- сначала пойми, действительно ли нужны права админа
Симптомы
- Команда отвечает 'No such file or directory'. Пытаешься открыть файл или зайти в папку, а её 'нет'.
Причина
Опечатка в имени файла или папки (регистр букв важен: Photos и photos -- разное) Ты находишься не в той папке, где лежит файл Путь относительный, а файл лежит в другом месте В имени есть пробел, и команда поняла его как два аргумента
Решение
- Сначала набери ls и убедись, что файл вообще есть рядом и написан так же
- Проверь регистр букв: report.txt и Report.txt -- разные файлы
- Перейди в нужную папку через cd, затем повтори команду
- Если в имени есть пробел, возьми его в кавычки: ls "My Folder" или используй имена без пробелов
Симптомы
- Делал cd несколько раз и потерялся. Команды не находят файлы, потому что ты 'не там'.
Причина
Несколько cd подряд увели в незнакомое место Не привык, что в терминале всегда есть 'текущая папка' Перепутал относительный и абсолютный путь
Решение
- Набери pwd -- он покажет полный путь до текущей папки
- Чтобы вернуться домой, набери cd ~ (или просто cd) -- это безопасная отправная точка
- Поднимайся вверх по одной папке через cd .. и проверяй pwd после каждого шага
- Привыкни начинать новую задачу с pwd и ls -- это как осмотреться по сторонам
Симптомы
- Один и тот же путь то работает, то нет, в зависимости от того, откуда его набираешь.
Причина
Относительный путь отсчитывается от текущей папки -- из другого места он ведёт не туда Забыл, что абсолютный путь начинается со слеша / Скопировал относительный путь из инструкции, не учтя, что у автора была другая текущая папка
Решение
- Если сомневаешься -- используй абсолютный путь (начинается с /): он работает из любой папки
- Помни: путь со слешем в начале -- абсолютный, без слеша -- относительный (от текущей папки)
- Используй ~ для домашней папки: ~/Documents/file.txt работает откуда угодно
- Проверяй pwd перед тем, как набирать относительный путь
Симптомы
- На Windows команда wsl --install выдаёт ошибку, ничего не скачивается, или после перезагрузки нет Linux-терминала.
Причина
Команду запускали не в PowerShell от имени администратора Не включена виртуализация в BIOS или компоненты Windows Старая версия Windows без поддержки WSL2 Не было перезагрузки после установки
Решение
- Открой PowerShell с правами администратора (правый клик -> 'Запуск от имени администратора') и снова набери wsl --install
- Обязательно перезагрузи компьютер после установки -- без этого Linux не появится
- Обнови Windows до актуальной версии (нужен Windows 10 версии 2004+ или Windows 11)
- Если жалуется на виртуализацию -- включи её в BIOS (пункт Virtualization / VT-x / SVM)
- После установки выбери Ubuntu в Windows Terminal и задай имя пользователя и пароль
Связанные уроки:
Симптомы
- На macOS набираешь brew install ..., а в ответ 'brew: command not found'.
Причина
Homebrew ещё не установлен Homebrew установлен, но его папка не прописана в PATH (частое на Apple Silicon) Не перезапустил терминал после установки
Решение
- Установи Homebrew с официального сайта brew.sh (одна команда, скопируй её туда)
- После установки выполни команды из подсказки установщика, добавляющие brew в PATH (обычно про eval ... shellenv)
- Закрой и открой терминал заново, затем проверь brew --version
- На Apple Silicon brew обычно в /opt/homebrew/bin -- убедись, что эта папка в PATH
Симптомы
- Набираешь apt install ..., а в ответ 'apt: command not found' или 'sudo: apt: command not found'.
Причина
Ты на macOS, где apt нет -- там пакетный менеджер brew У тебя дистрибутив Linux не на базе Debian/Ubuntu (apt только там) Забыл sudo перед apt
Решение
- Если ты на macOS -- используй brew install ... вместо apt
- На Ubuntu/Debian и в WSL2 (Ubuntu) пиши sudo apt update && sudo apt install ...
- На других Linux пакетный менеджер другой: dnf (Fedora), pacman (Arch) -- уточни под свою систему
- Не забывай sudo: установка требует прав администратора
Симптомы
- Команда docker run выдаёт 'Cannot connect to the Docker daemon' или 'docker daemon not running'.
Причина
Не запущено приложение Docker Desktop (или сервис Docker) Docker установлен, но ещё не стартовал после включения компьютера На Windows Docker не настроен на работу с WSL2
Решение
- Запусти приложение Docker Desktop и дождись, пока значок кита перестанет 'грузиться'
- На Linux запусти сервис: sudo systemctl start docker
- Подожди 10-30 секунд после старта -- движку нужно время на запуск
- На Windows в настройках Docker Desktop включи интеграцию с WSL2
- Проверь снова: docker run hello-world
Симптомы
- Вставил команду из статьи или чата, а терминал ругается -- хотя 'я же скопировал точь-в-точь'.
Причина
Скопировался лишний символ: значок приглашения $ или #, номер строки, кавычки-ёлочки Сайт подменил обычные кавычки на 'красивые' (умные кавычки), которые терминал не понимает Скопировалась только часть многострочной команды Команда была для другой ОС
Решение
- Убери из начала строки символ приглашения $ или # -- его копировать не нужно
- Перепечатай 'красивые' кавычки обычными прямыми " и ' руками
- Проверь, что скопировал команду целиком, особенно если она в несколько строк
- Убедись, что команда для твоей ОС (brew -- macOS, apt -- Linux/WSL2)
- Если не выходит -- набери команду вручную по буквам, так виднее лишние символы
Симптомы
- Команды не находят папку с русским названием или с пробелом, выдают странные ошибки или 'No such file or directory'.
Причина
Имя содержит пробел, и команда разбила его на части Кириллица в пути иногда отображается и копируется некорректно Скопированный путь содержит невидимые символы
Решение
- Бери пути с пробелами в кавычки: cd "Мои документы"
- Лучше: для учебных папок используй латиницу и дефисы вместо пробелов (my-project, а не 'Мой проект')
- Используй автодополнение клавишей Tab -- терминал сам подставит правильное имя и не ошибётся
- Держи учебные проекты в домашней папке с простыми именами, чтобы не воевать с путями
Связанные уроки:
Симптомы
- Запускаешь скрипт, а в нём старый код или пусто -- хотя ты вроде бы всё написал.
Причина
Не нажал сохранить (файл с несохранёнными правками) Сохранил, но в другую папку, а запускаешь из этой Сохранил с другим именем или расширением (hello.txt вместо hello.py) Редактировал не тот файл
Решение
- Сохрани файл: в VS Code это Cmd+S (macOS) или Ctrl+S (Windows/Linux); кружок на вкладке значит несохранённые правки
- Проверь, что запускаешь именно тот файл: сверь путь и имя через ls
- Убедись, что расширение .py, а не .txt -- иначе Python не тот файл
- Открой файл заново и посмотри cat hello.py: совпадает ли содержимое с тем, что писал
Симптомы
- Набираешь команды, но ничего не происходит, или курсор не возвращается после запуска команды.
Причина
Запущенная программа всё ещё работает и держит терминал (это нормально для серверов) Терминал ждёт продолжения команды (например, открытая кавычка) Случайно нажал паузу (Ctrl+S) -- вывод заморожен Запущен REPL или редактор, и ты не понял, что вышел в него
Решение
- Нажми Ctrl+C, чтобы прервать текущую команду и вернуть управление
- Если видишь >>> -- ты в Python REPL, набери exit() и нажми Enter
- Если строка начинается с > -- закрой незакрытую кавычку или нажми Ctrl+C
- Если вывод заморожен после Ctrl+S -- нажми Ctrl+Q, чтобы разморозить
- В крайнем случае закрой окно терминала и открой заново
Симптомы
- Установка прошла без ошибок, но команда по-прежнему выдаёт command not found.
Причина
Терминал не перезапущен и работает со старым PATH Папка с программой не добавлена в PATH Программа установилась под другим именем
Решение
- Закрой и открой терминал заново -- чаще всего этого хватает, чтобы подхватился новый PATH
- Проверь точное имя команды: иногда это python3, node, docker, а не то, что ты ждал
- Если папку нужно добавить в PATH -- следуй подсказке, которую вывел установщик
- Проверь which имя: если пусто -- программы реально нет в PATH
Симптомы
- После какой-то команды терминал превратился в редактор с текстом, и ни Esc, ни закрытие не помогают. Часто это редактор vim или nano.
Причина
Команда (например git) открыла встроенный редактор для ввода текста Случайно набрал vim или vi Не знаешь сочетания для выхода из конкретного редактора
Решение
- Если это nano (внизу подсказки с ^): нажми Ctrl+X, затем при вопросе о сохранении Y или N и Enter
- Если это vim (слева столбик ~): нажми Esc, затем набери :q! и Enter, чтобы выйти без сохранения
- Чтобы выйти из vim с сохранением: Esc, затем :wq и Enter
- На будущее можно задать редактор попроще через переменную окружения (например, EDITOR=nano)
Симптомы
- Набираешь git --version или git clone, а в ответ 'git: command not found'.
Причина
git ещё не установлен На macOS git ставится вместе с инструментами разработчика, которые ещё не доустановлены
Решение
- macOS: набери git --version -- система сама предложит доустановить инструменты разработчика; согласись. Или поставь через brew install git
- Ubuntu/WSL2: sudo apt update && sudo apt install git
- После установки закрой и открой терминал, затем снова git --version
- Windows без WSL2: скачай установщик с git-scm.com (но в курсе рекомендуем работать в WSL2)
Симптомы
- После команды вывалилась длинная красная простыня текста, и кажется, что всё сломалось.
Причина
Программа подробно описала, что пошло не так (это помощь, а не ругань) Это traceback Python -- список шагов до места ошибки Объём текста пугает, хотя суть обычно в одной-двух строках
Решение
- Не пугайся: красный текст -- это подсказка, а не приговор. Ничего не сломалось
- Читай последнюю строку -- там короткое описание ошибки (например, NameError, FileNotFoundError)
- Скопируй эту последнюю строку и вставь в поиск или в чат с ИИ
- Сверху traceback часто видно имя файла и номер строки -- туда и смотри в коде
Симптомы
- Описал проблему чат-боту, но ответ общий и не подошёл к твоему случаю.
Причина
В вопросе не было точного текста ошибки Не указал свою ОС (macOS / Windows+WSL2 / Linux) Не сказал, какую именно команду набирал Спросил слишком расплывчато ('не работает')
Решение
- Всегда указывай свою ОС: 'У меня macOS' / 'Windows с WSL2 Ubuntu'
- Вставляй ТОЧНЫЙ текст ошибки целиком, а не пересказ
- Пиши команду, которую набирал, дословно
- Скажи, что ты новичок и какого результата ждёшь -- получишь ответ попроще
- Если ответ не помог -- сообщи, что именно не сработало, и приложи новый вывод
Симптомы
- Каждое длинное имя файла и команду набираешь руками, делаешь опечатки, устаёшь.
Причина
Не знаешь про автодополнение клавишей Tab Не знаешь, что прошлые команды можно листать стрелками
Решение
- Печатай первые буквы имени файла/папки и жми Tab -- терминал допишет остальное сам
- Если вариантов несколько, нажми Tab дважды -- увидишь список
- Листай прошлые команды стрелками вверх/вниз -- не нужно набирать заново
- Эти две привычки экономят кучу времени и убирают опечатки
Связанные уроки:
Симптомы
- После установки Docker компьютер стал шумнее и медленнее, особенно сразу после включения.
Причина
Docker Desktop запускается автоматически при старте и держит ресурсы Запущены забытые контейнеры Docker выделено слишком много памяти в настройках
Решение
- Для этого курса Docker можно ставить, но не запускать постоянно -- открывай его только когда нужно
- Отключи автозапуск Docker Desktop при старте системы в его настройках
- Останови ненужные контейнеры: docker stop <id> (id видно в docker ps)
- В настройках Docker Desktop уменьши выделенную память, если её слишком много