파이썬 str과 repr 차이점 완벽 정리, print 출력과 디버깅까지

🔗 str과 repr은 어떤 차이가 있나요?

파이썬에서 객체를 문자열로 표현할 때는 두 가지 방법이 있습니다.
바로 __str__과 __repr__ 메서드를 사용하는 방식입니다.
하지만 두 메서드는 용도가 확실히 다릅니다.

__str__은 사람이 읽기 좋은 형태의 문자열을 반환합니다.
그래서 print 함수를 사용하거나 str() 함수를 사용할 때 자동으로 호출됩니다.
예를 들어 사용자에게 보여줄 깔끔한 정보가 필요할 때 __str__을 정의해두면 매우 유용하죠.

반면 __repr__은 개발자가 디버깅하거나 로깅을 할 때 객체의 내부 정보를 최대한 정확하게 보여주는 데 목적이 있습니다.
기본적으로 객체를 재구성할 수 있을 정도로 구체적인 정보를 담는 것이 좋습니다.

💬 __str__은 사용자 친화적인 문자열을, __repr__은 개발자 친화적인 문자열을 위한 메서드입니다.

간단한 예제를 통해 두 메서드의 차이를 살펴볼게요.

class Book:
    def __init__(self, title):
        self.title = title

    def __str__(self):
        return f'책 제목: {self.title}'

    def __repr__(self):
        return f'Book("{self.title}")'

b = Book("파이썬 기초")

print(str(b))   # 책 제목: 파이썬 기초
print(repr(b))  # Book("파이썬 기초")

위의 예시처럼 str은 설명형 표현, repr은 코드형 표현이라고 이해하면 됩니다.
각각의 목적이 다르기 때문에 상황에 따라 적절히 정의해두는 것이 중요합니다.

🛠️ print 함수에서의 동작 원리

파이썬에서 print() 함수를 호출하면 내부적으로 어떤 일이 일어날까요?
바로 __str__ 메서드가 우선적으로 호출됩니다.
만약 객체에 __str__이 정의되어 있지 않다면, 대신 __repr__이 호출되죠.

이처럼 print 함수는 사람에게 보여줄 문자열 표현을 생성하는 데 str을 우선합니다.
그렇기 때문에 사용자에게 전달하는 메시지나 UI에 노출되는 정보는 str에 알맞게 표현하는 것이 좋습니다.

반대로 __repr__은 print보다는 디버깅 콘솔이나 로그에 출력되는 경우가 많습니다.
예를 들어, 객체를 단순히 변수명으로 표현하거나 리스트, 딕셔너리 등에 담겨 있을 때 자동으로 repr이 사용되죠.

class User:
    def __init__(self, name):
        self.name = name

    def __repr__(self):
        return f'User("{self.name}")'

u = User("Tom")

print(u)       # User("Tom") → __str__이 없으므로 __repr__ 호출
users = [u]
print(users)   # [User("Tom")] → 리스트 안에 있으므로 __repr__ 호출

만약 str과 repr을 둘 다 정의했다면?

• 📌print(obj) → __str__ 호출
• 📌변수만 입력하거나 자료구조에 포함 → __repr__ 호출

이러한 동작 원리를 이해하고 나면, 왜 __str__과 __repr__을 따로 정의하는 것이 중요한지 분명하게 느껴지실 거예요.
각 상황에 맞게 적절한 출력을 제공하면 코딩 효율도 훨씬 높아집니다.

⚙️ 디버깅에 repr이 꼭 필요한 이유

파이썬에서 객체의 상태를 확인하거나 버그를 추적할 때는 print보다 디버깅이 훨씬 더 중요한 순간입니다.
이럴 때 유용하게 활용되는 것이 바로 __repr__ 메서드입니다.

repr은 단순한 보기용 출력을 넘어, 해당 객체를 재현할 수 있는 정보를 제공하는 것을 목표로 합니다.
이 덕분에 로그 기록이나 예외 메시지 출력, 또는 데이터 분석 도구에서 객체 상태를 그대로 출력할 때도 큰 도움이 됩니다.

예를 들어, 여러 개의 객체가 리스트나 딕셔너리 안에 들어 있을 때, str이 아닌 repr이 호출되어 개발자가 전체 구조를 쉽게 파악할 수 있습니다.
또한, Jupyter Notebook 같은 환경에서는 객체를 셀 마지막 줄에 쓰기만 해도 __repr__이 자동 호출되어 편리하게 객체 내용을 볼 수 있습니다.

class Order:
    def __init__(self, item, qty):
        self.item = item
        self.qty = qty

    def __repr__(self):
        return f'Order("{self.item}", {self.qty})'

orders = [Order("Pencil", 3), Order("Eraser", 5)]
print(orders)
# 출력 결과: [Order("Pencil", 3), Order("Eraser", 5)]

repr을 정의해두지 않았다면 위 결과는 주소값으로만 출력되어 아무런 도움이 되지 않았을 거예요.
이처럼 디버깅의 핵심은 명확한 객체 표현이며, 그 중심에 repr이 있습니다.

🔌 str과 repr 재정의 예제 보기

이제 str과 repr의 개념과 용도를 이해했다면, 실전에서 객체에 어떻게 재정의하면 되는지 구체적인 예제를 통해 살펴보겠습니다.
두 메서드는 클래스 내부에서 간단히 오버라이드할 수 있으며, 목적에 따라 표현 방식을 달리하는 것이 핵심입니다.

예를 들어 쇼핑몰 주문 객체를 정의한다고 가정해보겠습니다.
사용자에게는 ‘주문 상품명’과 같은 간결한 정보만 보여주고 싶고, 개발자 입장에서는 주문 객체를 정확히 추적하고 싶은 상황이라면 str과 repr을 다음처럼 다르게 구현할 수 있습니다.

class Order:
    def __init__(self, order_id, item, qty):
        self.order_id = order_id
        self.item = item
        self.qty = qty

    def __str__(self):
        return f'{self.item} {self.qty}개 주문 완료'

    def __repr__(self):
        return f'Order("{self.order_id}", "{self.item}", {self.qty})'

o = Order("A001", "키보드", 2)

print(str(o))    # 키보드 2개 주문 완료
print(repr(o))   # Order("A001", "키보드", 2)

이처럼 str은 사용자에게 보여질 출력 메시지를 정의하고,
repr은 디버깅 또는 객체 재생성을 위한 명확한 정보를 표현하는 데 중점을 둡니다.

또한, 클래스 안에 둘 다 정의하지 않을 경우 파이썬은 기본적으로 메모리 주소를 출력하게 되는데,
이럴 땐 사용자도, 개발자도 객체의 상태를 확인할 수 없어 매우 불편합니다.
따라서 str과 repr을 모두 적절히 정의해두는 것이 바람직한 객체지향 프로그래밍 습관이라 할 수 있습니다.

💡 실전에서 str과 repr 활용 팁

str과 repr은 단순히 객체 출력을 예쁘게 하기 위한 도구가 아닙니다.
실제 개발 과정에서는 디버깅, 로깅, 예외 처리, 데이터 직렬화 등 다양한 상황에서 이 두 메서드를 적절히 활용하는 것이 큰 차이를 만듭니다.

🧩 다양한 활용 시나리오

• 📝에러 메시지 출력 시 repr이 자동 호출되므로 객체의 내부 상태를 명확히 표현해줘야 추적이 수월합니다.
• 📋데이터 분석 시 pandas, numpy 등에서도 repr이 호출되어 표 형식으로 잘 보이도록 하는 것이 중요합니다.
• 🔍웹 API 출력에서 str은 사용자에게 노출되므로 간결하고 읽기 좋은 형태로 구성해야 합니다.

🧠 구현 시 고려할 점

str은 가독성을 위해 최대한 간결하게, 사용자가 바로 이해할 수 있는 표현으로 작성하는 것이 좋습니다.
반면 repr은 객체를 복원할 수 있을 정도로 상세한 정보를 담도록 설계하는 것이 바람직합니다.

💬 str은 “사용자 중심”, repr은 “개발자 중심”이라는 개념을 항상 기억하세요.

또한 팀 프로젝트에서는 클래스마다 repr을 통일된 포맷으로 작성해두면 디버깅 시 전체 객체를 빠르게 파악할 수 있습니다.
로깅 라이브러리(loguru 등)를 활용하는 경우에도 repr 정의 여부가 로그 메시지의 질을 크게 좌우하죠.

결국 str과 repr은 객체지향 프로그래밍에서 가장 기본적인 출력 인터페이스로,
객체의 외부 커뮤니케이션을 설계할 때 반드시 고려해야 할 요소입니다.

❓ 자주 묻는 질문 (FAQ)