프로그래밍언어/파이썬[Error]

[파이썬][Error] 008. SyntaxError - 'return' outside function

about_IT 2025. 5. 25. 22:31
728x90

SyntaxError: 'return' outside function 오류는 return 문이 함수 정의(def) 블록 밖에서 사용되었을 때 발생합니다. return은 함수 내에서 값을 반환하거나 실행을 중단하기 위해 사용되는 키워드이기 때문에, 함수의 문맥 밖에서는 허용되지 않습니다.

이 오류는 종종 함수를 작성한다고 생각하고 return 문을 사용했지만, 실제로는 함수 블록이 존재하지 않거나 들여쓰기 실수로 인해 함수 외부로 잘못 작성된 경우에 발생합니다.

● 오류 발생 예시

x = 10
return x

위 코드는 함수 정의 없이 return을 사용했기 때문에 다음과 같은 오류가 발생합니다.

SyntaxError: 'return' outside function

● 올바른 사용 예시

def get_value():
    x = 10
    return x

result = get_value()

위 예시는 return이 함수 get_value 내에 포함되어 있기 때문에 정상적으로 작동합니다.

● 자주 하는 실수

  • 함수 없이 단독으로 return 사용
  • def 키워드를 빠뜨려 함수가 정의되지 않은 경우
  • 함수 내부라고 생각했지만 들여쓰기 오류로 함수 바깥에 return이 작성된 경우

● 디버깅 팁

  • return 문이 반드시 def로 정의된 함수 블록 안에 있는지 확인
  • 함수의 들여쓰기 범위를 코드 편집기에서 시각적으로 확인
  • 여러 함수가 중첩된 경우, return이 올바른 함수에 속해 있는지 확인

● 결론

return 문은 함수 실행 중 반환값을 전달하거나 흐름을 중단하기 위한 키워드이므로, 반드시 함수 정의(def) 내부에서만 사용되어야 합니다. 그 외의 위치에서 사용하면 SyntaxError: 'return' outside function 오류가 발생하며, 이는 파이썬 문법적으로 허용되지 않는 구조입니다. 이러한 오류를 방지하려면 함수 구조와 들여쓰기를 철저히 점검해야 합니다.

728x90