SyntaxErrorとは
Pythonでプログラムを実行した際、SyntaxErrorは最も頻繁に遭遇するエラーの一種です。このエラーは、コードの「文法」がPythonのルールに従っていないことを意味します。コンパイル言語とは異なり、Pythonは実行時に構文解析を行い、ルール違反を検出すると処理を即座に停止します。
このエラーは、論理的なバグ（意図した通りに動かない）とは異なり、コードが機械的に読めない状態です。そのため、変数の値が正しくないというよりは、構文自体を修正する必要があります。多くの初心者が最初の壁として直面しますが、発生パターンは限られており、パターンを押さえれば解決は迅速です。
SyntaxErrorとはで迷っていませんか？
実例コードも交えながら、つまずきやすいポイントを順番に整理します。
順番に確認できる形でまとめているので、必要なところからすぐ試せます。
エラーメッセージの見方
エラーメッセージには、エラーが発生したファイル名、行番号、および原因の概要が含まれています。例えば以下のようになります。
File "example.py", line 5
print("Hello"
^
SyntaxError: unexpected EOF while parsingこの例では、example.pyというファイルの5行目で問題が発生していることを示しています。キャレット（^）は、エラーと判断された位置を指し示します。ただし、^が示す位置は必ずしも誤りのある文字そのものではなく、直前の閉じ忘れや構文不完全な領域の末尾を指していることがほとんどです。そのため、^の位置ではなく、その手前の行を確認する癖をつけることが重要です。
ポイント: エラー行は「正解」の行ではなく、「発見された行」です。問題の原因は通常、その直前やその行の途中にあります。
よくある原因と解決策
以下に、Pythonで頻発するSyntaxErrorの主要な5つのパターンと、具体的な解決方法を解説します。
インデント（字下げ）の不一致
Pythonはブロック構造をスペースまたはタブのインデントで管理します。そのため、インデントが揃っていないと構文エラーとなります。
典型的なケース:
if文やfor文の後にインデントされていないブロックが続く- インデントにスペースとタブが混在している
再現コード:
if True:
print("Indendation error") # ここがエラー解決策:
ブロック内のコードは、少なくとも1つのスペース（またはタブ）でインデントしてください。Pythonの公式スタイルガイド（PEP 8）では、4つのスペースを1インデント単位とするよう推奨されています。
if True:
print("Indendation error") # 先頭にスペース4つまた、エディタの設定を確認し、タブとスペースが混在していないか確認してください。混在していると視覚的には揃っていても、機械的には異なる文字として認識されます。VS CodeやPyCharmなどのIDEを使用している場合は、インデント設定が「Space 4」になっているか確認しましょう。
括弧の閉じ忘れ
括弧（()）や波括弧（{}）、角括弧（[]）の対応が取れていない場合に発生します。特にネスト（入れ子）が深くなったり、長い行の末尾で起きたりすると見逃しやすくなります。
典型的なケース:
- 関数呼び出しの括弧が開いたまま
- リストの括弧が開いたまま
- 文字列の閉じ括弧がない
再現コード:
print("Open bracket解決策:
コードの末尾付近から順に括弧を確認するか、エディタの括弧のハイライト機能を使用して対応関係を確認します。また、長い行で括弧を使う場合は、適宜改行を入れて可読性を高めましょう。
print(
"Open bracket"
)注意: エラーメッセージに「unexpected EOF while parsing」と出た場合、ファイルの末尾まで読み込んでいるにもかかわらず、まだ構文が完結していないことを意味します。閉じ括弧の欠落を疑ってください。
コロンの欠落
Pythonでは、ブロックが始まる行の末尾にはコロン（:）が必要です。これが欠けていると構文エラーとなります。
典型的なケース:
if,else,elif文の末尾に:がないfor,whileループの末尾に:がないclass定義の末尾に:がないdef関数定義の末尾に:がない
再現コード:
if True
print("Missing colon")解決策:
条件分岐やループ、関数定義などのステートメント行の末尾に、必ずコロンを追加してください。
if True:
print("Missing colon")このエラーは、他の言語（CやJavaなど）でコロンを使わない言語に慣れている場合に出会いやすいミスです。Pythonでは「ブロックの始まり」を明示する必要があることを忘れず、コロンを忘れずに付けましょう。
キーワードの誤用
Pythonには予約語（キーワード）があり、これらは変数名や関数名として使用できません。また、文法として使用されるべき場所で誤って使うとSyntaxErrorとなります。
典型的なケース:
ifを関数名や変数名に使おうとしたprintを関数名として再定義しようとした- 文法上不自然な場所にキーワードが入った
再現コード:
def if(a):
print(a)解決策:
予約語一覧を確認し、使用していない名前を割り当ててください。Pythonの予約語は以下のように確認できます。
import keyword
print(keyword.kwlist)
# ['False', 'None', 'True', 'and', 'as', 'assert', 'break', 'class', 'continue', 'def', 'del', 'elif', 'else', 'except', 'finally', 'for', 'from', 'global', 'if', 'import', 'in', 'is', 'lambda', 'nonlocal', 'not', 'or', 'pass', 'raise', 'return', 'try', 'while', 'with', 'yield']特殊文字や全角文字の混入
ソースコードには通常、半角英数字と記号のみを使用します。全角文字や特殊な改行コードが混入すると、解析できずにエラーになります。
典型的なケース:
- 全角の括弧（
（））やコロン（：）を使う - スペースとして全角スペース（
- 文字列内で閉じ文字列のクォートが全角になっている
再現コード:
print（"Hello"） # 全角括弧解決策:
使用しているエディタで、不可視文字の表示を有効にし、全角文字や不要なスペースがないか確認してください。また、テキストファイルとして保存する際に、文字コードがUTF-8になっているか確認しましょう。
トラブルシューティングの手法
SyntaxErrorに出会った際の効率的な解決手順をまとめます。
エラーメッセージの確認
エラーが指摘した行番号と、^の位置を確認する。ただし、直前の行も視野に入れる。
構文のチェック
上記で挙げた5つのパターン（インデント、括弧、コロン、キーワード、特殊文字）を順に確認する。
最小限のコードでの検証
問題が複雑な場合、エラーの起こる部分を最小限のコードに切り出し、別ファイルで試す。これにより、他のコードとの干渉を排除できる。
エディタの活用
静的解析ツールやLinter（例: Pylint, Flake8）をエディタに導入し、実行前に構文エラーを検知させる環境を整える。
注意: 修正後、エラーが出なくなったからといって、ロジックが正しいとは限りません。構文エラーは「読めるコード」にした状態であり、動作確認は別途行う必要があります。
まとめ
PythonのSyntaxErrorは、文法ルールを逸脱しているために発生します。主な原因はインデント、括弧、コロン、キーワード、特殊文字の5つに集約されます。エラーメッセージが示す行番号を手がかりに、直前のコードを確認し、これらのパターンに当てはまるか検討しましょう。
解決の鍵は、エディタのサポート機能を活用することと、基本ルールを整理しておくことです。特に、インデントとコロンはPythonの構文の根幹をなす部分なので、常に意識してコードを書く癖をつけましょう。また、エラーメッセージを恐れず、具体的なヒントとして読み解く姿勢が、迅速な解決につながります。
FAQ
PythonのSyntaxErrorとNameErrorの違いは何ですか？
SyntaxErrorは「文法が間違っている」ためコードが実行前に停止するエラーです。一方、NameErrorは「変数や関数が定義されていない」という実行時のエラーであり、文法自体は正しくても、その変数が存在しない場合に発生します。まずSyntaxErrorを解決し、コードが実行可能にしてからNameErrorを確認します。
エラーメッセージの行番号と実際の誤りの位置が違う場合がありますが、なぜですか？
Pythonはコードを一行ずつ解析していくのではなく、ある程度のチャンク（かたまり）で構文解析を行います。そのため、エラーが見つかった行が必ずしも誤りのある行とは限りません。特に、閉じ括弧の欠落やブロックの終わりが見えなくなった場合、ファイルの末尾（EOF）まで読み込んでからエラーを検知することがあります。その場合、エラー行より前の行、特にブロックの始まりを確認する必要があります。
SyntaxErrorが出た場合、最初に見るべき箇所はどこですか？
エラーメッセージが表示された行、およびその直前の行を確認してください。Pythonでは、直前の行で閉じていない括弧やコロンが原因で、次の行でエラーが検知されることがよくあります。また、エディタで「構文強調表示」が正しく機能しているか確認することも重要です。強調表示が崩れている場所は、構文が壊れている可能性が高いです。
ここまで読んでいただきありがとうございます！
UdemyのPythonコースにはオンラインで学習ができる動画コンテンツがたくさんあります。
当ブログのような文章メインの説明では足りない箇所を補えると思うので、もっと詳しく勉強したいという方はぜひチェックしてみてください！
コメント