AI에게 코드를 받아서 실행했는데, 오류가 발생하는 경우를 많이 마주할 수 있습니다.
그럼 코드를 작성하는데 이미 많은 토큰을 소모했는데, 오류를 수정하느라 또 토큰을 사용하게 되죠.
간단한 오류라서 내가 수정할 수 있는 사항이라 내가 고친다면?
'토큰' 즉 비용을 아낄 수 있게 되겠죠.
오늘 배울 오류는 가장 쉽게 만나는 오류 중 하나 바로 SyntaxError 입니다.
처음 보면 당황스럽지만, 대부분 괄호, 콜론 등 문법 요소가 빠졌을 때 발생합니다.
이번 글에서는 SyntaxError가 무엇인지, 어떻게 고치면 좋은지 간단한 예시와 함께 보겠습니다.
SyntaxError는 프로그래밍 언어에서 문법에 맞지 않는 코드를 작성했을 때 발생하는 오류입니다.
컴퓨터가 코드를 읽다가 "이건 모르는 규칙인데?"라고 판단하면 나오는 오류죠.
# syntax errors
def greet(name):
print("Hello, " + name
if True
print("This will cause a syntax error")
''' 주석 남기기
print("Python Comment")
AI에게 코드를 하나 작성해달라고 했습니다.
이걸 그대로 실행을 해보면 어떤 결과가 나올까요?
AI는 똑똑하니 제대로 실행이 될까요?
한번 실행해보겠습니다.

실행했더니 정상적으로 실행되지 않고 무슨 영어 문장이 나옵니다.
한 줄씩 읽어볼까요?
File "C:\python\test.py", line 9
제가 실행한 파일명과 무슨 줄 번호가 나오네요.
''' 주석 남기기
^
그 밑에는 내 코드가 직접적으로 나오고 있습니다.
SyntaxError: unterminated triple-quoted string literal (detected at line 11)
오류와 오류의 상세사항이 나와있습니다. 읽어보면
문법오류 : 끝나지 않은 삼중 따옴표 문자열 리터럴(줄 11에서 감지됨)
이라고 적혀있네요.
파이썬에서 삼중 따옴표는 여러줄 주석을 남길때 사용됩니다.
''' 주석 '''
""" 주석 """
이런식으로요.
하지만 예시와 활용의 차이점이 보이시나요?
활용에서는 따옴표가 글 시작과 마무리에 감싸고 있는 형태로 사용되고 있습니다.
이러한 규칙을 지키지 않으면 컴퓨터는 SyntaxError를 띄우게 되는 것입니다.
''' 주석 남기기 '''
# 주석 남기기
한번 정상적으로 작동하게 주석을 수정해보았습니다.
삼중 따옴표 문법을 사용해도 좋지만 한줄짜리 주석이기에 #을 활용해서 작성해도 좋겠죠.
이대로 실행해보겠습니다.

이번에도 가차없이 SyntaxError가 발생했습니다.
우리는 위에서 배운 것처럼 오류를 보기위해서 맨 아랫줄만 읽어볼까요?
'(' was never closed
AI가 다중 작업을 하다보면 가장 많이 실수하는 부분입니다.
( 가 닫히지 않았다고 적혀있네요.
그럼 오류의 위치를 확인해서 수정해주면 간단하게 수정이 되겠죠? 찾아서 ')'를 활용해서 닫아줍시다.
# syntax errors
def greet(name):
print("Hello, " + name)

한번 더 실행해보면 안타깝게도 또 오류가 발생합니다.
이번에는 ':'가 없다고 하네요.
코드를 보니 AI가 또 실수를 했습니다.
Python에서 if, for, def같은 함수를 사용하면 뒤에 :를 작성해주어야 하는 규칙을 지키지 않았네요.
간단하게 :만 넣어주면 되는 오류인데 내가 할줄 모른다면?
AI가 코드를 다시 읽고 수정하느라고 토큰을 사용하게 되었겠네요.
수정한대로 작성한뒤 실행해주면

아 드디어 코드가 정상적으로 작동이 되는군요!
훌륭해요! AI의 도움을 받지 않고서 에러코드를 수정할 수 있게 되었습니다.
사실 오늘 살펴본 SyntaxError 같은 경우에는 VSCode같은 IDE를 활용한다면
실행해보지 않고도 오류를 쉽게 발견할 수 있습니다.

제 VSCode 화면을 가져와봤습니다.
보면 한글이나 워드 작성해보셨나요? 맞춤법을 틀리면 빨간 물결표로 알려주잖아요?
VSCode도 문법을 틀리면 스타일에 따라 다르지만 저렇게 표시를 해줍니다.
하지만 이건 VSCode가 문법대로 코드를 한번 읽어서 알려주는 것이기 때문에,
코드가 길어지면 읽는 시간이 오래걸려 알려주지 못할 때도 있으니, 실행했을때 오류가 난다고 VSCode를 욕하진 말아주세요!
오래 걸렸는데도 제건 빨갛거나 뭐 알려주는게 없는데요? 하시는 분들도 있을 수 있습니다.
이 같은 경우에는 제가 소개글에 작성했던 VSCode 설정인 extentions에서 python을 설치하지 않아서
VSCode가 python 문법을 몰라서 발생하는 일일 수 있습니다! 한번 설치해주세요.

그래서 SyntaxError 어떤 방식으로 수정해야 효율적인데요?
아래는 코딩을 하면서 SyntaxError가 발생할 경우 확인하면 좋은 순서입니다.
1. 주석문 오류 확인
2. 괄호, 따옴표 제대로 닫혔는지 확인
3. ':' 확인
4. 들여쓰기 확인
5. 에러 표시된 줄 윗부분 확인
제가 매우 주관적으로 느낀 AI가 코딩하면서 자주 실수하는 순서입니다.
5번도 꽤 중요한데요, 윗부분이 문제가 있지만 아랫부분에 오류가 있다고 출력되는 경우가 꽤 많기 때문입니다.
오늘은 SyntaxError에 대해 한번 알아보았습니다.
처음에는 당연히 문법을 모르니 어렵게 느껴질 수 있다고 생각합니다.
하지만 대부분은 오류 설명을 읽고, 확인하면 문법을 몰라도 해결할 수 있습니다.
AI가 코드를 작성해주더라도, 이런 기본적인 오류들을 읽고 수정하는 능력은 익혀놓으면 좋겠죠?
다음 글에서는 SyntaxError처럼 AI의 코드에서 자주 발생하는 다른 오류들도 하나씩 정리해보겠습니다.
'AI 코딩 > 오류 읽기 시리즈' 카테고리의 다른 글
| AI 코딩할 때 꼭 알아야 할 오류 읽는법 : IndexError (0) | 2026.04.27 |
|---|---|
| AI 코딩할 때 꼭 알아야 할 오류 읽는 법 : TypeError (0) | 2026.04.24 |
| AI 코딩할 때 꼭 알아야 할 오류 읽는 법 : ModuleNotFoundError (0) | 2026.04.24 |
| AI 코딩할 때 꼭 알아야 할 오류 읽는 법 : IndentationError (0) | 2026.04.23 |
| AI 코딩할 때 꼭 알아야 할 오류 읽는 법 : NameError (0) | 2026.04.23 |