Как исправить syntax error invalid syntax python

SyntaxError — это ошибка, которая легко может ввести в ступор начинающего программиста. Стоит забыть одну запятую или не там поставить кавычку и Python наотрез откажется запускать программу. Что ещё хуже, по выводу в консоль сложно сообразить в чём дело. Выглядят сообщения страшно и непонятно. Что с этим делать — не ясно. Вот неполный список того, что можно встретить:

• SyntaxError: invalid syntax
• SyntaxError: EOL while scanning string literal
• SyntaxError: unexpected EOF while parsing

Эта статья о том, как справиться с синтаксической ошибкой SyntaxError. Дочитайте её до конца и получите безотказный простой алгоритм действий, что поможет вам в трудную минуту — ваш спасательный круг.

Работать будем с программой, которая выводит на экран список учеников. Её код выглядит немного громоздко и, возможно, непривычно. Если не всё написанное вам понятно, то не отчаивайтесь, чтению статьи это не помешает.

students = [
    ['Егор', 'Кузьмин'],
    ['Денис', 'Давыдов'],
]

for first_name, last_name in students:
    label = 'Имя ученика: {first_name} {last_name}'.format(
        first_name = first_name
        last_name = last_name
    )

    print(label)

Ожидается примерно такой результат в консоли:

$ python script.py
Имя ученика: Егор Кузьмин
Имя ученика: Денис Давыдов

Но запуск программы приводит к совсем другому результату. Скрипт сломан:

$ python script.py
  File "script.py", line 9
    last_name = last_name
            ^
SyntaxError: invalid syntax

Ошибки в программе бывают разные и каждой нужен свой особый подход. Первым делом внимательно посмотрите на вывод программы в консоль. На последней строчке написано SyntaxError: invalid syntax. Если эти слова вам не знакомы, то обратитесь за переводом к Яндекс.Переводчику:

SyntaxError: недопустимый синтаксис
SyntaxError: неверный синтаксис

Первое слово SyntaxError Яндекс не понял. Помогите ему и разделите слова пробелом:

Syntax Error: invalid syntax
Синтаксическая ошибка: неверный синтаксис

Теория. Синтаксические ошибки

Программирование — это не магия, а Python — не волшебный шар. Он не умеет предсказывать будущее, у него нет доступа к секретным знаниями, это просто автомат, это программа. Узнайте как она работает, как ищет ошибки в коде, и тогда легко найдете эффективный способ отладки. Вся необходимая теория собрана в этом разделе, дочитайте до конца.

SyntaxError — это синтаксическая ошибка. Она случается очень рано, еще до того, как Python запустит программу. Вот что делает компьютер, когда вы запускаете скрипт командой python script.py:

1. запускает программу python
2. python считывает текст из файла script.py
3. python превращает текст программы в инструкции
4. python исполняет инструкции

Синтаксическая ошибка SyntaxError возникает на четвёртом этапе в момент, когда Python разбирает текст программы на понятные ему компоненты. Сложные выражения в коде он разбирает на простейшие инструкции. Вот пример кода и инструкции для него:

person = {'name': 'Евгений'}

Инструкции:

1. создать строку 'Евгений'
2. создать словарь
3. в словарь добавить ключ 'name' со значением 'Евгений'
4. присвоить результат переменной person

SyntaxError случается когда Python не смог разбить сложный код на простые инструкции. Зная это, вы можете вручную разбить код на инструкции, чтобы затем проверить каждую из них по отдельности. Ошибка прячется в одной из инструкций.

1. Найдите поломанное выражение

Этот шаг сэкономит вам кучу сил. Найдите в программе сломанный участок кода. Его вам предстоит разобрать на отдельные инструкции. Посмотрите на вывод программы в консоль:

$ python script.py
  File "script.py", line 9
    last_name = last_name
            ^
SyntaxError: invalid syntax

Вторая строчка сообщает: File "script.py", line 9 — ошибка в файле script.py на девятой строчке. Но эта строка является частью более сложного выражения, посмотрите на него целиком:

label = 'Имя ученика: {first_name} {last_name}'.format(
    first_name = first_name
    last_name = last_name
)

«Девман» — авторская методика обучения программированию. Готовим к работе крутых программистов на Python. Станьте программистом, пройдите продвинутый курс Python.

2. Разбейте выражение на инструкции

В прошлых шагах вы узнали что сломан этот фрагмент кода:

label = 'Имя ученика: {first_name} {last_name}'.format(
    first_name = first_name
    last_name = last_name
)

Разберите его на инструкции:

1. создать строку 'Имя ученика: {first_name} {last_name}'
2. получить у строки метод format
3. вызвать функцию с двумя аргументами
4. результат присвоить переменной label

Так выделил бы инструкции программист, но вот Python сделать так не смог и сломался. Пора выяснить на какой инструкции нашла коса на камень.

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

# 1. создать строку
template = 'Имя ученика: {first_name} {last_name}'

label = template.format(
    first_name = first_name
    last_name = last_name
)

Сразу запустите код, проверьте что ошибка осталась на прежнему месте. Приступайте ко второй инструкции:

# 1. создать строку
template = 'Имя ученика: {first_name} {last_name}'

# 2. получить у строки метод
format = template.format

label = format(
    first_name = first_name
    last_name = last_name
)

Строка format = template.format создает новую переменную format и кладёт в неё функцию. Да, да, это не ошибка! Python разрешает класть в переменные всё что угодно, в том числе и функции. Новая переменная переменная format теперь работает как обычная функция, и её можно вызвать: format(...).

Снова запустите код. Ошибка появится внутри format. Под сомнением остались две инструкции:

1. вызвать функцию с двумя аргументами
2. результат присвоить переменной label

Скорее всего, Python не распознал вызов функции. Проверьте это, избавьтесь от последней инструкции — от создания переменной label:

# 1. создать строку
template = 'Имя ученика: {first_name} {last_name}'

# 2. получить у строки метод
format = template.format

# 3. вызвать функцию
format(
    first_name = first_name
    last_name = last_name
)

Запустите код. Ошибка снова там же — внутри format. Выходит, код вызова функции написан с ошибкой, Python не смог его превратить в инструкцию.

3. Проверьте синтаксис вызова функции

Теперь вы знаете что проблема в коде, вызывающем функцию. Можно помедитировать еще немного над кодом программы, пройтись по нему зорким взглядом еще разок в надежде на лучшее. А можно поискать в сети примеры кода для сравнения.

Запросите у Яндекса статьи по фразе “Python синтаксис функции”, а в них поищите код, похожий на вызов format и сравните. Вот одна из первых статей в поисковой выдаче:

• Функции в Python

Уверен, теперь вы нашли ошибку. Победа!

Watch Now This tutorial has a related video course created by the Real Python team. Watch it together with the written tutorial to deepen your understanding: Identify Invalid Python Syntax

Python is known for its simple syntax. However, when you’re learning Python for the first time or when you’ve come to Python with a solid background in another programming language, you may run into some things that Python doesn’t allow. If you’ve ever received a SyntaxError when trying to run your Python code, then this guide can help you. Throughout this tutorial, you’ll see common examples of invalid syntax in Python and learn how to resolve the issue.

By the end of this tutorial, you’ll be able to:

• Identify invalid syntax in Python
• Make sense of SyntaxError tracebacks
• Resolve invalid syntax or prevent it altogether

 1# theofficefacts.py
 2ages = {
 3    'pam': 24,
 4    'jim': 24
 5    'michael': 43
 6}
 7print(f'Michael is {ages["michael"]} years old.')

$ python theofficefacts.py
File "theofficefacts.py", line 5
    'michael': 43
            ^
SyntaxError: invalid syntax

>>> len('hello') = 5
  File "<stdin>", line 1
SyntaxError: can't assign to function call

>>> 'foo' = 1
  File "<stdin>", line 1
SyntaxError: can't assign to literal

>>> 1 = 'foo'
  File "<stdin>", line 1
SyntaxError: can't assign to literal

>>> len('hello') == 5
True

>>> fro i in range(10):
  File "<stdin>", line 1
    fro i in range(10):
        ^
SyntaxError: invalid syntax

>>> for i range(10):
  File "<stdin>", line 1
    for i range(10):
              ^
SyntaxError: invalid syntax

>>> names = ['pam', 'jim', 'michael']
>>> if 'jim' in names:
...     print('jim found')
...     break
...
  File "<stdin>", line 3
SyntaxError: 'break' outside loop

>>> if 'jim' in names:
...     print('jim found')
...     continue
...
  File "<stdin>", line 3
SyntaxError: 'continue' not properly in loop

>>> pass = True
  File "<stdin>", line 1
    pass = True
         ^
SyntaxError: invalid syntax

>>> def pass():
  File "<stdin>", line 1
    def pass():
           ^
SyntaxError: invalid syntax

import keyword
print(keyword.kwlist)

>>> import keyword; keyword.iskeyword('pass')
True

>>> message = 'don't'
  File "<stdin>", line 1
    message = 'don't'
                   ^
SyntaxError: invalid syntax

>>> message = "This is an unclosed string
  File "<stdin>", line 1
    message = "This is an unclosed string
                                        ^
SyntaxError: EOL while scanning string literal

 1# theofficefacts.py
 2ages = {
 3    'pam': 24,
 4    'jim': 24,
 5    'michael': 43
 6}
 7print(f'Michael is {ages["michael]} years old.')

$ python theofficefacts.py
  File "theofficefacts.py", line 7
    print(f'Michael is {ages["michael]} years old.')
         ^
SyntaxError: f-string: unterminated string

# missing.py
def foo():
    return [1, 2, 3

print(foo())

$ python missing.py
  File "missing.py", line 5
    print(foo())
        ^
SyntaxError: invalid syntax

# missing.py
def foo():
    return [1, 2, 3,

print(foo())

$ python missing.py
  File "missing.py", line 6

                ^
SyntaxError: unexpected EOF while parsing

>>> ages = {'pam'=24}
  File "<stdin>", line 1
    ages = {'pam'=24}
                 ^
SyntaxError: invalid syntax

>>> ages = dict(pam=24)
>>> ages
{'pam': 24}

 1# indentation.py
 2def foo():
 3    for i in range(10):
 4        print(i)
 5  print('done')
 6
 7foo()

$ python indentation.py
  File "indentation.py", line 5
    print('done')
                ^
IndentationError: unindent does not match any outer indentation level

 1# indentation.py
 2def foo():
 3    for i in range(10):
 4        print(i)
 5    print('done')
 6
 7foo()

$ tabs 4 # Sets the shell tab width to 4 spaces
$ cat -n indentation.py
     1   # indentation.py
     2   def foo():
     3       for i in range(10)
     4           print(i)
     5       print('done')
     6   
     7   foo()

$ tabs 8 # Sets the shell tab width to 8 spaces (standard)
$ cat -n indentation.py
     1   # indentation.py
     2   def foo():
     3       for i in range(10)
     4           print(i)
     5           print('done')
     6   
     7   foo()

$ tabs 3 # Sets the shell tab width to 3 spaces
$ cat -n indentation.py
     1   # indentation.py
     2   def foo():
     3       for i in range(10)
     4           print(i)
     5      print('done')
     6   
     7   foo()

$ python indentation.py
  File "indentation.py", line 5
    print('done')
                ^
TabError: inconsistent use of tabs and spaces in indentation

>>> def fun();
  File "<stdin>", line 1
    def fun();
             ^
SyntaxError: invalid syntax

>>> def fun(a, b):
...     print(a, b)
...
>>> fun(a=1, 2)
  File "<stdin>", line 1
SyntaxError: positional argument follows keyword argument

>>> # Valid Python 2 syntax that fails in Python 3
>>> print 'hello'
  File "<stdin>", line 1
    print 'hello'
                ^
SyntaxError: Missing parentheses in call to 'print'. Did you mean print('hello')?

>>> # Any version of python before 3.6 including 2.7
>>> w ='world'
>>> print(f'hello, {w}')
  File "<stdin>", line 1
    print(f'hello, {w}')
                      ^
SyntaxError: invalid syntax

>>> [(1,2)(2,3)]
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'tuple' object is not callable

>>> [(1,2)(2,3)]
<stdin>:1: SyntaxWarning: 'tuple' object is not callable; perhaps you missed a comma?
Traceback (most recent call last):   
  File "<stdin>", line 1, in <module>    
TypeError: 'tuple' object is not callable

Watch Now This tutorial has a related video course created by the Real Python team. Watch it together with the written tutorial to deepen your understanding: Identify Invalid Python Syntax

Ситуация: программист взял в работу математический проект — ему нужно написать код, который будет считать функции и выводить результаты. В задании написано:

«Пусть у нас есть функция f(x,y) = xy, которая перемножает два аргумента и возвращает полученное значение».

Программист садится и пишет код:

a = 10
b = 15
result = 0
def fun(x,y): 
    return x y
result = fun(a,b)
print(result)

Но при выполнении такого кода компьютер выдаёт ошибку:

File "main.py", line 13
result = x y
^
❌ SyntaxError: invalid syntax

Почему так происходит: в каждом языке программирования есть свой синтаксис — правила написания и оформления команд. В Python тоже есть свой синтаксис, по которому для умножения нельзя просто поставить рядом две переменных, как в математике. Интерпретатор находит первую переменную и думает, что ему сейчас объяснят, что с ней делать. Но вместо этого он сразу находит вторую переменную. Интерпретатор не знает, как именно нужно их обработать, потому что у него нет правила «Если две переменные стоят рядом, их нужно перемножить». Поэтому интерпретатор останавливается и говорит, что у него лапки. 

Что делать с ошибкой SyntaxError: invalid syntax

В нашем случае достаточно поставить звёздочку (знак умножения в Python) между переменными — это оператор умножения, который Python знает:

a = 10
b = 15
result = 0
def fun(x,y): 
    return x * y
result = fun(a,b)
print(result)

В общем случае найти источник ошибки SyntaxError: invalid syntax можно так:

Практика

Попробуйте найти ошибки в этих фрагментах кода:

x = 10 y = 15
def fun(x,y): 
    return x * y

try:  
    a = 100
    b = "PythonRu"
    assert a = b
except AssertionError:  
    print("Исключение AssertionError.")
else:  
    print("Успех, нет ошибок!")

Неверный синтаксис в Python

Когда вы запускаете ваш код Python, интерпретатор сначала анализирует его, чтобы преобразовать в байтовый код Python, который он затем выполнит. Интерпретатор найдет любой недопустимый синтаксис в Python на этом первом этапе выполнения программы, также известном как этап синтаксического анализа . Если интерпретатор не может успешно проанализировать ваш код Python, это означает, что вы использовали неверный синтаксис где-то в вашем коде. Переводчик попытается показать вам, где произошла эта ошибка.

Когда вы изучаете Python в первый раз, может быть неприятно получить + SyntaxError +. Python попытается помочь вам определить, где в вашем коде указан неверный синтаксис, но предоставляемый им traceback может немного сбить с толку. Иногда код, на который он указывает, вполне подходит.

*Примечание:* Если ваш код *синтаксически* правильный, то вы можете получить другие исключения, которые не являются `+ SyntaxError +`. Чтобы узнать больше о других исключениях Python и о том, как их обрабатывать, ознакомьтесь с https://realpython.com/python-exceptions/[Python Exceptions: Введение].

Вы не можете обрабатывать неправильный синтаксис в Python, как и другие исключения. Даже если вы попытаетесь обернуть блок + try + и + кроме + вокруг кода с неверным синтаксисом, вы все равно увидите, что интерпретатор вызовет + SyntaxError +.

+ SyntaxError + Исключение и трассировка

Когда интерпретатор обнаруживает неверный синтаксис в коде Python, он вызовет исключение + SyntaxError + и предоставит трассировку с некоторой полезной информацией, которая поможет вам отладить ошибку. Вот некоторый код, который содержит недопустимый синтаксис в Python:

 1 # theofficefacts.py
 2 ages = {
 3     'pam': 24,
 4     'jim': 24
 5     'michael': 43
 6 }
 7 print(f'Michael is {ages["michael"]} years old.')

Вы можете увидеть недопустимый синтаксис в литерале словаря в строке 4. Во второй записи + 'jim' + пропущена запятая. Если вы попытаетесь запустить этот код как есть, вы получите следующую трассировку:

$ python theofficefacts.py
File "theofficefacts.py", line 5
    'michael': 43
            ^
SyntaxError: invalid syntax

Обратите внимание, что сообщение трассировки обнаруживает ошибку в строке 5, а не в строке 4. Интерпретатор Python пытается указать, где находится неправильный синтаксис. Тем не менее, он может только указать, где он впервые заметил проблему. Когда вы получите трассировку + SyntaxError + и код, на который указывает трассировка, выглядит нормально, тогда вы захотите начать движение назад по коду, пока не сможете определить, что не так.

В приведенном выше примере нет проблемы с запятой, в зависимости от того, что следует после нее. Например, нет проблемы с отсутствующей запятой после + 'michael' + в строке 5. Но как только переводчик сталкивается с чем-то, что не имеет смысла, он может лишь указать вам на первое, что он обнаружил, что он не может понять.

*Примечание:* В этом руководстве предполагается, что вы знакомы с основами *tracebacks* в Python. Чтобы узнать больше о трассировке Python и о том, как их читать, ознакомьтесь с https://realpython.com/python-traceback/[Understanding Python Traceback].

Существует несколько элементов трассировки + SyntaxError +, которые могут помочь вам определить, где в вашем коде содержится неверный синтаксис:

В приведенном выше примере имя файла было + theofficefacts.py +, номер строки был 5, а каретка указывала на закрывающую кавычку из словарного ключа + michael +. Трассировка + SyntaxError + может не указывать на реальную проблему, но она будет указывать на первое место, где интерпретатор не может понять синтаксис.

Есть два других исключения, которые вы можете увидеть в Python. Они эквивалентны + SyntaxError +, но имеют разные имена:

Оба эти исключения наследуются от класса + SyntaxError +, но это особые случаи, когда речь идет об отступе. + IndentationError + возникает, когда уровни отступа вашего кода не совпадают. + TabError + возникает, когда ваш код использует и табуляцию, и пробелы в одном файле. Вы познакомитесь с этими исключениями более подробно в следующем разделе.

Общие проблемы с синтаксисом

Когда вы впервые сталкиваетесь с + SyntaxError +, полезно знать, почему возникла проблема и что вы можете сделать, чтобы исправить неверный синтаксис в вашем коде Python. В следующих разделах вы увидите некоторые из наиболее распространенных причин, по которым может быть вызвано «+ SyntaxError +», и способы их устранения.

>>> len('hello') = 5
  File "<stdin>", line 1
SyntaxError: can't assign to function call

>>> 'foo' = 1
  File "<stdin>", line 1
SyntaxError: can't assign to literal

>>> 1 = 'foo'
  File "<stdin>", line 1
SyntaxError: can't assign to literal

*Примечание:* В приведенных выше примерах отсутствует повторяющаяся строка кода и каретка (`+ ^ +`), указывающая на проблему в трассировке. Исключение и обратная трассировка, которые вы видите, будут другими, когда вы находитесь в REPL и пытаетесь выполнить этот код из файла. Если бы этот код был в файле, то вы бы получили повторяющуюся строку кода и указали на проблему, как вы видели в других случаях в этом руководстве.

>>> len('hello') == 5
True

>>> fro i in range(10):
  File "<stdin>", line 1
    fro i in range(10):
        ^
SyntaxError: invalid syntax

>>> for i range(10):
  File "<stdin>", line 1
    for i range(10):
              ^
SyntaxError: invalid syntax

>>> names = ['pam', 'jim', 'michael']
>>> if 'jim' in names:
...     print('jim found')
...     break
...
  File "<stdin>", line 3
SyntaxError: 'break' outside loop

>>> if 'jim' in names:
...     print('jim found')
...     continue
...
  File "<stdin>", line 3
SyntaxError: 'continue' not properly in loop

>>> pass = True
  File "<stdin>", line 1
    pass = True
         ^
SyntaxError: invalid syntax

>>> def pass():
  File "<stdin>", line 1
    def pass():
           ^
SyntaxError: invalid syntax

import keyword
print(keyword.kwlist)

>>> import keyword; keyword.iskeyword('pass')
True

>>> message = 'don't'
  File "<stdin>", line 1
    message = 'don't'
                   ^
SyntaxError: invalid syntax

>>> message = "This is an unclosed string
  File "<stdin>", line 1
    message = "This is an unclosed string
                                        ^
SyntaxError: EOL while scanning string literal

 1 # theofficefacts.py
 2 ages = {
 3     'pam': 24,
 4     'jim': 24,
 5     'michael': 43
 6 }
 7 print(f'Michael is {ages["michael]} years old.')

$ python theofficefacts.py
  File "theofficefacts.py", line 7
    print(f'Michael is {ages["michael]} years old.')
         ^
SyntaxError: f-string: unterminated string

# missing.py
def foo():
    return [1, 2, 3

print(foo())

$ python missing.py
  File "missing.py", line 5
    print(foo())
        ^
SyntaxError: invalid syntax

# missing.py
def foo():
    return [1, 2, 3,

print(foo())

$ python missing.py
  File "missing.py", line 6

                ^
SyntaxError: unexpected EOF while parsing

>>> ages = {'pam'=24}
  File "<stdin>", line 1
    ages = {'pam'=24}
                 ^
SyntaxError: invalid syntax

>>> ages = dict(pam=24)
>>> ages
{'pam': 24}

 1 # indentation.py
 2 def foo():
 3     for i in range(10):
 4         print(i)
 5   print('done')
 6
 7 foo()

$ python indentation.py
  File "indentation.py", line 5
    print('done')
                ^
IndentationError: unindent does not match any outer indentation level

 1 # indentation.py
 2 def foo():
 3     for i in range(10):
 4         print(i)
 5     print('done')
 6
 7 foo()

$ tabs 4 # Sets the shell tab width to 4 spaces
$ cat -n indentation.py
     1   # indentation.py
     2   def foo():
     3       for i in range(10)
     4           print(i)
     5       print('done')
     6
     7   foo()

$ tabs 8 # Sets the shell tab width to 8 spaces (standard)
$ cat -n indentation.py
     1   # indentation.py
     2   def foo():
     3       for i in range(10)
     4           print(i)
     5           print('done')
     6
     7   foo()

$ tabs 3 # Sets the shell tab width to 3 spaces
$ cat -n indentation.py
     1   # indentation.py
     2   def foo():
     3       for i in range(10)
     4           print(i)
     5      print('done')
     6
     7   foo()

$ python indentation.py
  File "indentation.py", line 5
    print('done')
                ^
TabError: inconsistent use of tabs and spaces in indentation

>>> def fun();
  File "<stdin>", line 1
    def fun();
             ^
SyntaxError: invalid syntax

>>> def fun(a, b):
...     print(a, b)
...
>>> fun(a=1, 2)
  File "<stdin>", line 1
SyntaxError: positional argument follows keyword argument

>>> # Valid Python 2 syntax that fails in Python 3
>>> print 'hello'
  File "<stdin>", line 1
    print 'hello'
                ^
SyntaxError: Missing parentheses in call to 'print'. Did you mean print('hello')?

>>> # Any version of python before 3.6 including 2.7
>>> w ='world'
>>> print(f'hello, {w}')
  File "<stdin>", line 1
    print(f'hello, {w}')
                      ^
SyntaxError: invalid syntax

>>> [(1,2)(2,3)]
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'tuple' object is not callable

>>> [(1,2)(2,3)]
<stdin>:1: SyntaxWarning: 'tuple' object is not callable; perhaps you missed a comma?
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
TypeError: 'tuple' object is not callable

Заключение

В этом руководстве вы увидели, какую информацию предоставляет обратная связь + SyntaxError +. Вы также видели много распространенных примеров неправильного синтаксиса в Python и каковы решения этих проблем. Это не только ускорит ваш рабочий процесс, но и сделает вас более полезным рецензентом кода!

Когда вы пишете код, попробуйте использовать IDE, который понимает синтаксис Python и предоставляет обратную связь. Если вы поместите многие из недопустимых примеров кода Python из этого руководства в хорошую IDE, то они должны выделить проблемные строки, прежде чем вы даже сможете выполнить свой код.

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

It’s a sadly unhelpful error message and it’s one that you’ll see quite often when learning Python.

What does SyntaxError: invalid syntax mean?
What is Python trying to tell you with this error and how can you fix your code to make Python happy?

What is a SyntaxError in Python?

This is Python’s way of saying «I don’t understand you».
Python knows that what you’ve typed isn’t valid Python code but it’s not sure what advice to give you.

When you’re lucky, your SyntaxError will have some helpful advice in it:

$ python3 greet.py
  File "/home/trey/greet.py", line 10
    if name == "Trey"
                     ^
SyntaxError: expected ':'

But if you’re unlucky, you’ll see the message invalid syntax with nothing more:

$ python3.9 greet.py
  File "/home/trey/greet.py", line 4
    name
    ^
SyntaxError: invalid syntax

This error message gives us no hints as to what might be going on outside of a line number and a bit of highlighting indicating where Python thinks the error occurred.

Causes of SyntaxError: invalid syntax

What are the likely causes of this mysterious error message?

When my Python students hit this error, the most likely causes are typically:

1. Missing a colon (:) at the end of a line or mixing up other symbols
2. Missing opening or closing parentheses ((…)), brackets ([…]), braces ({…}), or quotes ("…")
3. Misspelled or missing keywords or mistyping syntax within a block or expression
4. Attempting to use a reserved keyword as a variable name
5. Incorrectly indented code or other whitespace errors
6. Treating statements like expressions
7. Copying Python code into the REPL or copying from the REPL into a Python file

That’s a lot of options and they’re not the only options.
How should you approach fixing this problem?

Fixing SyntaxError: invalid syntax

The first step in fixing SyntaxErrors is narrowing down the problem.

I usually take the approach of:

1. Note the line number and error message from the traceback, keeping in mind that both of these just guesses that Python’s making
2. Working through the above list of common causes
3. Attempting to read the code as Python would, looking for syntax mistakes
4. Narrowing down the problem by removing blocks of code that I suspect may be the culprit

It’s easier to address that dreaded SyntaxError: invalid syntax exception when you’re familiar with its most common causes.
Let’s attempt to build up our intuitions around SyntaxError: invalid syntax by touring the common causes of this error message.

Upgrading Python improves error messages

Before diving into specific errors, note that upgrading your Python version can drastically improve the helpfulness of common error messages.

Take this error message:

$ python3 square.py
  File "/home/trey/square.py", line 2
    return [
    ^
SyntaxError: invalid syntax

On Python 3.10 it looks considerably different:

$ python3.10 square.py
  File "/home/trey/square.py", line 1
    def square_all(numbers:
                  ^
SyntaxError: '(' was never closed

We’re running the same square.py file in both cases:

def square_all(numbers:
    return [
        n**2
        for n in numbers
    ]

But Python 3.10 showed a much more helpful message: the line number, the position, and the error message itself are all much clearer for many unclosed parentheses and braces on Python 3.10 and above.

The dreaded missing colon is another example.
Any expression that starts a new block of code needs a : at the end.

Here’s the error that Python 3.9 shows for a missing colon:

$ python3 greet.py
  File "/home/trey/greet.py", line 10
    if name == "Trey"
                     ^
SyntaxError: invalid syntax

And here’s the same error in Python 3.10:

$ python3 greet.py
  File "/home/trey/greet.py", line 10
    if name == "Trey"
                     ^
SyntaxError: expected ':'

Much more helpful, right?
It’s still a SyntaxError exception, but the message is much clearer than simply invalid syntax.

Python 3.10 also includes friendlier error messages when you use = where you likely meant ==:

>>> name = "Trey"
>>> if name = "Trey":
  File "<stdin>", line 1
    if name = "Trey":
       ^^^^^^^^^^^^^
SyntaxError: invalid syntax. Maybe you meant '==' or ':=' instead of '='?

Newer Python versions include more helpful error messages for missing commas, inline if expressions, unclosed braces/brackets/parentheses, and more.

If you have the ability to run your code on a newer version of Python, try it out.
It might help you troubleshoot your syntax errors more effectively.

Count your parentheses

Forgetting closing parentheses, brackets, and braces is also a common source of coding errors.

Fortunately, recent Python versions have started noting unclosed brackets in their SyntaxError messages.

When running this code:

def colors():
    c = ['red',
        'blue',
    return c

Python 3.9 used to show simply invalid syntax:

$ python3.9 colors.py
  File "/home/trey/colors.py", line 4
    return c
    ^
SyntaxError: invalid syntax

But Python 3.10 shows a more helpful error message:

$ python3.10 colors.py
  File "/home/trey/colors.py", line 2
    c = ['red',
        ^
SyntaxError: '[' was never closed

But sometimes Python can get a little confused when guessing the cause of an error.
Take this populate.py script:

import random
import names

random_list=["a1","a2","a3","b1","b2","b3","c1","c2","c3"]

with open("one.txt","w+") as one, 
     open("two.txt","w+") as two, 
     open("three.txt","w+") as three:
      for i in range(0,3):
          one.write("%sn" "%s" % (names.get_first_name(),
              random.choice(random_list))
          two.write("%sn" "%s" % (names.get_first_name(),
              random.choice(random_list))
          three.write("%sn" "%s" % (names.get_first_name(),
              random.choice(random_list))

When running this script, Python 3.10 shows this error message:

$ python3.10 populate.py
  File "/home/trey/populate.py", line 9
    one.write("%sn" "%s" %
              ^^^^^^^^^^^^^
SyntaxError: invalid syntax. Perhaps you forgot a comma?

The problem is that all 3 of those write method calls are missing closing parentheses.

Count your parentheses!

Many code editors highlight matching parentheses, brackets, and braces (when your cursor is at an opening parentheses the closing one will change color).
Use your code editor to see if each pair of parenthesis matches up properly (and that the one in matches seems correct).

Misspelled, missing, or misplaced keywords

Can you see what’s wrong with this line of code?

>>> drf sum_of_squares(numbers):
  File "<stdin>", line 1
    drf sum_of_squares(numbers):
        ^
SyntaxError: invalid syntax

We were trying to define a function, but we misspelled def as drf.
Python couldn’t figure out what we were trying to do, so it showed us that generic invalid syntax message.

What about this one?

>>> numbers = [2, 1, 3, 4, 7, 11, 18]
>>> squares = [n**2 for numbers]
  File "<stdin>", line 1
    squares = [n**2 for numbers]
                               ^
SyntaxError: invalid syntax

Python’s pointing to the end of our comprehension and saying there’s a syntax error.
But why?

Look a bit closer.
There’s something missing in our comprehension.

We meant type this:

>>> numbers = [2, 1, 3, 4, 7, 11, 18]
>>> squares = [n**2 for n in numbers]

We were missing the in in our comprehension’s looping component.

Misspelled keywords and missing keywords often result in that mysterious invalid syntax, but extra keywords can cause trouble as well.

You can’t use reserved words as variable names in Python:

>>> class = "druid"
  File "<stdin>", line 1
    class = "druid"
          ^
SyntaxError: invalid syntax

Python sees that word class and it assumes we’re defining a class.
But then it sees an = sign and gets confused and can’t tell what we’re trying to do, so it throws its hands in the error and yells invalid syntax!

This one is a bit more mysterious:

>>> import urlopen from urllib.request
  File "<stdin>", line 1
    import urlopen from urllib.request
                   ^^^^
SyntaxError: invalid syntax

That looks right, doesn’t it?
So what’s the problem?

In Python the import…from syntax is actually a from…import syntax.
We meant to write this instead:

>>> from urllib.request import urlopen

Watch out for misspelled keywords, missing keywords, and re-arranged syntax.
Also be sure not to use reserved words as variable names (e.g. class, return, and import are invalid variable names).

Subtle spacing problems

Can you see what’s wrong in this code?

>>> class Thing:
...     def __init _(self, name, color):
  File "<stdin>", line 2
    def __init _(self, name, color):
               ^
SyntaxError: invalid syntax

Notice the extra space in the function name (__init_ _ instead of __init__)?

Can you identify what’s wrong in this line?

>>> class Thing:
...     def__init__(self, name, color):
  File "<stdin>", line 2
    def__init__(self, name, color):
                                  ^
SyntaxError: invalid syntax

This one might be harder to spot.

Everything on that line is correct except that there’s no space between def and __init__.

When one space character is valid, you can usually use more than one space character as well.
But adding an extra space in the middle of an identifier or removing spaces where there should be spaces can often cause syntax errors.

Forgotten quotes and extra quotes

If you code infrequently, you likely forget to put quotes around your strings often.
This is a very common mistake, so rest assured that you’re not alone!

Forgotten quotes can sometimes result in this cryptic invalid syntax error message:

>>> print(Four!) if n
  File "<stdin>", line 1
    print(Four!) if n
              ^
SyntaxError: invalid syntax

Be careful with quotes within quotes:

>>> question = 'What's that?'
  File "<stdin>", line 1
    question = 'What's that?'
                     ^
SyntaxError: invalid syntax

You’ll need to switch to a different quote style (using double quotes for example) or escape those quotes.

Mixing up your symbols

Sometimes your syntax might look correct but you’ve actually confused one bit of syntax for another common bit of syntax.

That’s what happened here:

>>> things = {duck='purple', monkey='green'}
  File "<stdin>", line 1
    things = {duck='purple', monkey='green'}
              ^^^^^^^^^^^^^
SyntaxError: invalid syntax. Maybe you meant '==' or ':=' instead of '='?

We’re trying to make a dictionary and we’ve accidentally used = instead of : to separate our key-value pairs.

Here’s another dictionary symbol mix up:

>>> states = [
...     'Oregon': 'OR',
  File "<stdin>", line 2
    'Oregon': 'OR',
            ^
SyntaxError: invalid syntax

It looks like we’re trying to define a dictionary, but we started with an open square bracket ([) instead of an open curly brace ({).

Another common syntax mistake is missing periods:

  File "/home/trey/file_info.py", line 15
    size = path.stat()st_size
                      ^^^^^^^
SyntaxError: invalid syntax

We’re trying to access the st_size attribute on the object returned from that path.stat() call, but we’ve forgot to put a . before st_size.

Sometimes syntax errors are due to characters being swapped around:

>>> name = "Trey"
>>> name[]0
  File "<stdin>", line 1
    name[]0
         ^
SyntaxError: invalid syntax

And some syntax errors are due to extra symbols you didn’t intend to write:

>>> name = "Trey"
>>> name.lower.()
  File "<stdin>", line 1
    name.lower.()
               ^
SyntaxError: invalid syntax

We wrote an extra . before our parentheses above.

Indentation errors in disguise

Sometimes a SyntaxError is actually an indentation error in disguise.

For example this code has an else clause that’s too far indented:

import sys

name = sys.argv[1]

if name == "Trey":
    print("I know you")
    print("Your name is Troy... no, Trent? Trevor??")
    else:
        print("Hello stranger")

When we run the code we’ll see a SyntaxError:

$ python greet.py
  File "/home/trey/greet.py", line 8
    else:
    ^^^^
SyntaxError: invalid syntax

Indentation issues often result in IndentationError exceptions, but sometimes they’ll manifest as SyntaxError exceptions instead.

Embedding statements within statements

A «statement» is either a block of Python code or a single line of Python code that can stand on its own.

An «expression» is a chunk of Python code that evaluates to a value.
Expressions contain identifiers (i.e. variables), literals (e.g. [1, 2], "hi", and 4), and operators (e.g. +, in, and *).

In Python we can embed one expression within another.
But some expressions are actually «statements» which must be a line all on their own.

Here we’ve tried to embed one statement within another:

>>> def square_all(numbers):
...     return result = [n**2 for n in numbers]
  File "<stdin>", line 2
    return result = [n**2 for n in numbers]
                  ^
SyntaxError: invalid syntax

Assignments are statements in Python (result = ... is a statement).
Python’s return is also a statement.
We’ve tried to embed one statement inside another and Python didn’t understand us.

We likely meant either this:

def square_all(numbers):
    result = [n**2 for n in numbers]
    return result

Or this:

def square_all(numbers):
    return [n**2 for n in numbers]

Here’s the same issue with the global statement (see assigning to global variables):

>>> def connect(*args, **kwargs):
...     global _connection = sqlite3.connect(*args, **kwargs)
  File "<stdin>", line 2
    global _connection = sqlite3.connect(*args, **kwargs)
                       ^
SyntaxError: invalid syntax

And the same issue with the del statement:

trey_count = del counts['Trey']
  File "<stdin>", line 1
    trey_count = del counts['Trey']
                 ^^^
SyntaxError: invalid syntax

If assignment is involved in your statement-inside-a-statement, an assignment expression (via Python’s walrus operator) may be helpful in resolving your issue.
Though often the simplest solution is to split your code into multiple statements over multiple lines.

Errors that appear only in the Python REPL

Some errors are a bit less helpful within the Python REPL.

Take this invalid syntax error:

def square_all(numbers:
    return [
  File "<stdin>", line 2
    return [
    ^^^^^^
SyntaxError: invalid syntax

We’ll see that error within the Python REPL even on Python 3.11.

The issue is that the first line doesn’t have a closing parentheses.
Python 3.10+ would properly point this out if we ran our code from a .py file instead:

$ python3.10 square.py
  File "/home/trey/square.py", line 1
    def square_all(numbers:
                  ^
SyntaxError: '(' was never closed

But at the REPL Python doesn’t parse our code the same way (it parses block-by-block in the REPL) and sometimes error messages are a bit less helpful within the REPL as a result.

Here’s another REPL-specific error:

>>> def greet(name):
...     print(f"Howdy {name}!")
... greet("Trey")
  File "<stdin>", line 3
    greet("Trey")
    ^^^^^
SyntaxError: invalid syntax

This is valid Python code:

def greet(name):
    print(f"Howdy {name}!")
greet("Trey")

But that can’t be copy-pasted directly into the REPL.
In the Python REPL a blank line is needed after a block of code to end that block.

So we’d need to put a newline between the function definition and the function call:

>>> def greet(name):
...     print(f"Howdy {name}!")
...
>>> greet("Trey")
Howdy Trey!

Some errors are due to code that feels like it should work in a Python REPL but doesn’t.
For example running python from within your Python REPL doesn’t work:

>>> python greet.py
  File "<stdin>", line 1
    python greet.py
           ^^^^^
SyntaxError: invalid syntax
>>> python -m pip install django
  File "<stdin>", line 1
    python -m pip install django
              ^^^
SyntaxError: invalid syntax

The above commands would work from our system command-prompt, but they don’t work within the Python REPL.

If you’re trying to launch Python or send a command to your prompt outside Python (like ls or dir), you’ll need to do it from your system command prompt (Terminal, Powershell, Command Prompt, etc.).
You can only type valid Python code from within the Python REPL.

Problems copy-pasting from the REPL

Copy-pasting from the Python REPL into a .py file will also result in syntax errors.

Here’s we’re running a file that has >>> prefixes before each line:

$ python numbers.py
  File "/home/trey/numbers.py", line 1
    >>> n = 4
    ^^
SyntaxError: invalid syntax

This isn’t a valid Python program:

>>> n = 4
>>> print(n**2)

But this is a valid Python program:

You’ll need to be careful about empty lines when copy-pasting from a .py file into a Python REPL and you’ll need to be careful about >>> and ... prefixes and command output when copy-pasting from a REPL into a .py file.

The line number is just a «best guess»

It used to be that the line number for an error would usually represent the place that Python got confused about your syntax.
That line number was often one or more lines after the actual error.

In recent versions of Python, the core developers have updated these line numbers in an attempt to make them more accurate.

For example here’s an error on Python 3.9 due to a missing comma:

$ python3.9 greet.py
  File "/home/trey/greet.py", line 4
    name
    ^
SyntaxError: invalid syntax

And here’s the same error in Python 3.10:

$ python3.10 greet.py
  File "/home/greet.py", line 3
    "Hello there"
    ^^^^^^^^^^^^^
SyntaxError: invalid syntax. Perhaps you forgot a comma?

Python’s given us a helpful hint on Python 3.10.
But it’s also made a different guess about what line the error is on.

As you can see from the greet.py file, line 3 ("Hello there") is the better guess in this case, as that’s where the comma is needed.

def greet(name):
    print(
        "Hello there"
        name
    )

While deciphering tracebacks, keep in mind that the line number is just Python’s best guess as to where the error occurred.

SyntaxError exceptions happen all the time

If your code frequently results in SyntaxError exceptions, don’t fret.
These kinds of exceptions happen all the time.
When you’re newer to Python, you’ll find that it’s often a challenge to remember the exact syntax for the statements you’re writing.

But more experienced Python programmers also experience syntax errors.
I make typos in my code quite often.
I have a linter installed in my text editor to help me catch those typos though.
I recommend searching for a «Python» or «Python linter» extension for your favorite code editor so you can spot these issues quickly every time you save your .py files.

Once you get past syntax errors, you’ll likely hit other types of exceptions. Watch the exception screencast series for more on reading tracebacks and exception handling in Python.