Поиск
Ошибки

Python: SyntaxError: invalid syntax — ошибка в тексте программы

Python не может прочитать текст программы: пропущены двоеточие, скобка или кавычка, в коде лишний знак или код написан для другой версии Python. Программа не запускается совсем.

≈ 7 мин чтения
Содержание 9

Как выглядит ошибка

  File "/home/ivan/myapp/app.py", line 5
    if user == 'admin'
…
SyntaxError: expected ':'

Python показывает файл, номер строки и саму строку, а под ней ставит знаки ^ там, где заметил ошибку, — здесь вместо них многоточие. В последней строке — текст ошибки. Если программа запущена службой, ищите эти строки в журнале: sudo journalctl -u myapp -n 30 (про journalctl). Тексты ошибок сверены с исходным кодом Python 3.12.3 — эта версия стоит в Ubuntu 24.04 — и Python 3.14.4 из пакета python3.14 в Ubuntu 26.04.

Что значит сообщение

Текст ошибкиЧто не такЧто сделать
expected ':'в конце строки с if, for, while, def или class нет двоеточиядопишите : в конце строки
'(' was never closedскобка открыта и не закрыта; вместо ( может стоять [ или {закройте скобку из сообщения
unmatched ')'лишняя закрывающая скобкауберите её или допишите открывающую
closing parenthesis ']' does not match opening parenthesis '('открыта круглая скобка, а закрыта квадратнаяпоставьте закрывающую скобку того же вида
unterminated string literal (detected at line 5)у текста в кавычках нет закрывающей кавычкидопишите кавычку того же вида в конце текста
invalid syntax. Perhaps you forgot a comma?между элементами списка или аргументами функции нет запятойдопишите запятую
invalid syntax. Maybe you meant '==' or ':=' instead of '='?в условии стоит = вместо сравнения ==замените = на ==
Missing parentheses in call to 'print'. Did you mean print(...)?код написан для Python 2: там print пишется без скобоквозьмите версию программы для Python 3 или допишите скобки
invalid decimal literalсразу после числа идут буквы, например 2daysимя переменной не может начинаться с цифры — переименуйте её
invalid character '“' (U+201C)в коде типографская кавычка вместо прямой — код скопирован из Word, мессенджера или с сайтанаберите кавычки заново — как
invalid non-printable character U+00A0в коде неразрывный пробел, на экране его не виднозамените его — как
Non-UTF-8 code starting with '\xcf'файл программы сохранён не в UTF-8, а в Windows-1251переведите файл в UTF-8 — как
invalid syntaxPython не смог понять строку и не нашёл подсказкипроверьте строку из сообщения и строку над ней

Python 3.14 при опечатке в слове вроде while или import может подсказать нужное слово: invalid syntax. Did you mean 'while'?. Ошибки отступов — IndentationError и TabError — разобраны на отдельной странице.

Шаг 1. Откройте строку из сообщения

Команды на этой странице вводятся на сервере: подключитесь к нему по SSH (как подключиться) и набирайте их в том же окне. Номер строки стоит после line, вместо app.py подставьте свой файл:

nano -l +5 app.py

Ключ -l покажет номера строк слева, +5 поставит курсор на пятую строку. Исправьте строку по таблице выше, сохраните файл — Ctrl+O и Enter, выйдите — Ctrl+X. Подробнее о редакторе — Редактор nano.

Если строка выглядит верной, смотрите строки над ней: пропущенная запятая или скобка в строке 4 может дать ошибку в строке 5, где Python её заметил.

Если в коде чужие знаки

Типографские кавычки “ ” ‘ ’ попадают в код, когда его копируют из текстового редактора, мессенджера или со страницы сайта. Откройте строку из сообщения в nano, удалите такие кавычки и наберите заново с клавиатуры в английской раскладке — ' или ".

Неразрывный пробел U+00A0 выглядит как пробел, поэтому найти его глазами нельзя. Замените все такие пробелы в файле. Сначала сделайте копию:

cp app.py app.py.bak

Затем замените их командой — Python прочитает файл, поменяет неразрывные пробелы на простые и запишет файл обратно:

python3 -c "import pathlib; p = pathlib.Path('app.py'); p.write_text(p.read_text(encoding='utf-8').replace('\xa0', ' '), encoding='utf-8')"

Если файл не в UTF-8

Python читает файл программы в кодировке UTF-8, и если файл сохранён в Windows-1251 — так делают старые редакторы для Windows, — Python остановится на первой русской букве:

SyntaxError: Non-UTF-8 code starting with '\xcf' in file /home/ivan/myapp/app.py on line 3, but no encoding declared; see https://peps.python.org/pep-0263/ for details

Сделайте копию и запишите файл заново в UTF-8:

cp app.py app.py.bak
iconv -f cp1251 -t utf-8 app.py.bak > app.py

Как узнать кодировку файла и что делать с файлами данных — на странице UnicodeDecodeError.

Если код написан для другой версии Python

Если ошибка в строке, которая выглядит верной, проверьте версию Python на сервере:

python3 --version

В Ubuntu 24.04 стоит Python 3.12, в Ubuntu 26.04 — 3.14 (подробнее). Код, написанный для новой версии, Python 3.12 может не понять: например запись except ValueError, TypeError: без скобок он не примет и напишет multiple exception types must be parenthesized. Какая версия нужна программе, указано в её описании или в файле pyproject.toml — в строке requires-python.

Ошибка про print без скобок означает обратное: код написан для Python 2, и нужна версия программы для Python 3.

Как проверить

Проверьте файл без запуска программы — Python только прочитает его:

python3 -m py_compile app.py && echo OK

Если ошибок нет, появится OK. Если ошибка осталась, Python покажет её так же, как в начале страницы: исправьте эту строку и проверьте снова. Если приложение запускается из окружения venv, проверяйте тем же Python: venv/bin/python -m py_compile app.py. Если приложение работает службой, перезапустите её: sudo systemctl restart myapp. Если приложение запущено как служба systemd, имя службы в примерах — myapp, папка — /home/ivan/myapp. Подставьте свои.

Источники

Сверено 22 октября 2026 года.

Где проверить исправление. Если ошибка случилась на рабочем сайте, исправление спокойнее сначала проверить на отдельном тестовом VPS с Ubuntu, например в Timeweb Cloud Реклама. АО «ТАЙМВЭБ», ИНН 7810353960. erid: CQH36pWzJpoBWKF332yG5h2XQ4cVubfBmkvqAitFqcpzWs. Как зайти на него после заказа — в статье Как подключиться к VPS по SSH.

Что почитать дальше