Python 异常 SyntaxError 语法错误

说明

《Python 教程》持续更新中，提供建议、纠错、催更等加作者微信: gairuo123（备注：pandas教程）和关注公众号「盖若」ID: gairuo。跟作者学习，请进入 Python学习课程。欢迎关注作者出版的书籍：《深入浅出Pandas》和《Python之光》。

当Python解释器遇到无法理解或解析的语法时，就会引发SyntaxError。这可能是由于诸如拼写错误、缺少括号或引号、缩进错误等常见问题导致的。语法错误在代码编写中会经常遇到，是由于代码不符合 Python 解释器的语法要求，无法正常运行。Python 会给出较明确的语法错误点及位置，我们进行分析定位很快就能修复。

示例

如以下代码，字符串少打了半个引号，会抛出SyntaxError等, 并告知错误内容，并将箭头指向错误发生的位置。

print('hello world!)
  File "<ipython-input-5-9ccf034fb7d1>", line 1
    print('hello world!)
                        ^
SyntaxError: EOL while scanning string literal

再如以下，是缩进不规范：

for i in range(3):
print(i)
  File "<stdin>", line 2
    print(i)
        ^
IndentationError: expected an indented block

SyntaxError

SyntaxError 类的介绍如下。

exception SyntaxError(message, details)

当解析器遇到语法错误时引发。这可以发生在 import 语句，对内置函数 compile(), exec() 或 eval() 的调用，或是读取原始脚本或标准输入（也包括交互模式）的时候。

异常实例的 str() 只返回错误消息。错误详情为一个元组，其成员也可在单独的属性中分别获取。

filename 发生语法错误所在文件的名称。
lineno 发生错误所在文件中的行号。行号索引从 1 开始：文件中首行的 lineno 为 1。
offset 发生错误所在文件中的列号。列号索引从 1 开始：行中首个字符的 offset 为 1。
text 错误所涉及的源代码文本。
end_lineno 发生的错误在文件中的末尾行号。这个索引是从 1 开始的：文件中首行的 lineno 为 1。
end_offset 发生的错误在文件中的末尾列号。这个索引是从 1 开始：行中首个字符的 offset 为 1。

对于 f-字符串字段中的错误，消息会带有 "f-string: " 前缀并且其位置是基于替换表达式构建的文本中的位置。例如，编译 f'Bad {a b} field' 将产生这样的 args 属性: ('f-string: ...', ('', 1, 2, '(a b)n', 1, 5))。

在 3.10 版本发生变更: 增加了 end_lineno 和 end_offset 属性。

常见语法错误

语法错误抛出的类型为 SyntaxError: <错误文案>，有些会明确在文案中告诉哪些方面错误了，有些则是 SyntaxError: invalid syntax, 就需要对代码进行具体分析。

如果有多个语法错误，“箭头”指向的第一个错误，解决一个继续尝试运行才能看到下一个。

常见的语法错误及可能的原因如下：

SyntaxError: invalid character in identifier: 逗号冒号等写成中文的了
SyntaxError: unexpected EOF while parsing: 少右边的括号
SyntaxError: EOL while scanning string literal: 字符串少右边的引号
IndentationError: expected an indented block: 没有缩进

怎么避免

语法错误其实是比较初级的一个错误，在初学时期经常发生。但随着对 Python 的学习深入应该尽量避免，否则解决语法问题会占用我们大量的时间。

熟练掌握 Python 语法规范，编写中认真投入，养成好的编程习惯，使用效率高的编辑器都可以帮助我们减少出错的概率。

一些好的代码编写习惯

比如：

学习 python PEP8 规范，它可以让我们避免一些坑，本教程也会提及部分
确保关键字正确，背会并正确拼写那几个单词
for、if、def、while 等后边都有冒号，别忘
引号、括号先成对打完，再跳到里边输入内容
留意缩进，代码的逻辑块一定要清晰
有些代码编辑器要手动保存，修改完保存一下再执行
可以把代码拆开分别执行，看哪块出错
没报错就是没反应？看是不是死循环

参考

https://docs.python.org/zh-cn/3.12/library/exceptions.html#SyntaxError