Python: SyntaxError: invalid syntax — ошибка в тексте программы
Python не может прочитать текст программы: пропущены двоеточие, скобка или кавычка, в коде лишний знак или код написан для другой версии Python. Программа не запускается совсем.
Содержание 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 syntax | Python не смог понять строку и не нашёл подсказки | проверьте строку из сообщения и строку над ней |
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. Подставьте свои.
Источники
- Исходный код Python 3.12.3: Grammar/python.gram — expected ':', Perhaps you forgot a comma, Maybe you meant '==', Missing parentheses, multiple exception types.
- Исходный код Python 3.12.3: Parser/pegen_errors.c — was never closed.
- Исходный код Python 3.12.3: Parser/tokenizer.c — unmatched, closing parenthesis, unterminated string literal, invalid decimal literal, invalid character, Non-UTF-8 code.
- Исходный код Python 3.14.4: Parser/lexer/lexer.c, Parser/tokenizer/helpers.c и Parser/pegen_errors.c — те же сообщения в Python 3.14.
- Исходный код Python 3.14.4: Lib/traceback.py — подсказка Did you mean при опечатке в слове.
- Исходный код Python 3.12.3: Lib/py_compile.py — что выводит python3 -m py_compile.
Сверено 22 октября 2026 года.
Что почитать дальше
- IndentationError и TabErrorошибки отступов.
- UnicodeDecodeErrorфайл в другой кодировке.
- Все ошибки Python и pipтаблица по тексту сообщения.