파이썬 클래스 기초부터 실전 OOP까지 완벽 정리

파이썬 클래스의 기초 개념을 붕어빵 틀 비유로 아주 쉽게 이해하고 객체지향 프로그래밍에 확실히 입문할 수 있어요. self, __init__, 인스턴스 변수와 클래스 변수 등 처음 배울 때 헷갈리기 쉬운 핵심 뼈대를 명확하게 잡아드릴게요. 나아가 PEP 8 네이밍 규칙과 타입 힌트를 적용해 요즘 실무에서 선호하는 모던 파이썬 코드 작성법을 배우고, 상속과 재고 관리 시스템 예제로 실무 감각까지 완벽하게 익혀봐요.

# 클래스 없이 변수로만 강아지 정보를 관리하는 방식이에요.
# 강아지가 100마리가 된다면 이런 변수를 200개나 만들어야 해요!
dog1_name = "Luna"  # 첫 번째 강아지의 이름 변수 생성
dog1_age = 3        # 첫 번째 강아지의 나이 변수 생성
dog2_name = "Rex"   # 두 번째 강아지의 이름 변수 생성
dog2_age = 5        # 두 번째 강아지의 나이 변수 생성

# 클래스를 사용해 강아지라는 '틀'을 만들고 정보를 관리하는 방식이에요.
class Dog:
    def __init__(self, name, age):  # 강아지를 만들 때 이름과 나이를 받아요.
        self.name = name            # 받은 이름을 자기 자신(self)의 이름으로 저장해요.
        self.age = age              # 받은 나이를 자기 자신(self)의 나이로 저장해요.

# 이제 강아지가 아무리 늘어나도 아주 깔끔하게 찍어낼 수 있어요.
luna = Dog("Luna", 3)  # 이름은 Luna, 나이는 3인 강아지 객체를 하나 만들어요.
rex = Dog("Rex", 5)    # 이름은 Rex, 나이는 5인 강아지 객체를 하나 더 만들어요.

# PEP 8 규칙에 따라 클래스 이름은 첫 글자를 대문자로(Dog) 깔끔하게 작성했어요.
class Dog:
    # 클래스 변수: 이 클래스로 만든 모든 강아지가 공통으로 공유하는 데이터예요.
    # 모든 강아지의 종은 동일하니까 이렇게 한 번만 선언해요.
    species: str = "Canis familiaris" 

    # 생성자 메서드: 인스턴스를 만들 때 무조건 처음 실행돼요.
    # name은 문자열(str), age는 정수(int)가 들어와야 한다고 타입 힌트를 적었어요.
    # -> None은 이 함수가 아무것도 반환하지 않는다는 뜻이에요.
    def __init__(self, name: str, age: int) -> None:
        # 인스턴스 변수: 각 강아지마다 다르게 가지는 독립적인 데이터예요.
        self.name: str = name  # 자기 자신(self)의 name 속성에 전달받은 name을 쏙 저장해요.
        self.age: int = age    # 자기 자신(self)의 age 속성에 전달받은 age를 쏙 저장해요.

    # 인스턴스 메서드: PEP 8 규칙에 따라 소문자로(introduce) 작성했어요.
    def introduce(self) -> str:
        # 자기 자신의 이름과 나이를 조합해 예쁜 문자열로 반환해요.
        return f"멍멍! 제 이름은 {self.name}이고, 나이는 {self.age}살이에요."

# Dog 클래스(틀)를 이용해 luna라는 인스턴스(붕어빵)를 만들어요.
luna = Dog("Luna", 3)
print(luna.introduce())  # 출력: 멍멍! 제 이름은 Luna이고, 나이는 3살이에요.

📌 Note

타입 힌트를 꼼꼼히 적어두면 코드를 읽는 동료도 편하고, VSCode나 PyCharm 같은 에디터가 어떤 데이터가 필요한지 알아서 추천해주기 때문에 오타나 타입 관련 실수를 획기적으로 줄일 수 있어요.

# 원을 다루는 Circle 클래스를 정의해요.
class Circle:
    # 모든 원이 공평하게 공유하는 파이(pi) 값을 클래스 변수로 설정해요.
    pi: float = 3.14159

    # 반지름(radius)을 받아 인스턴스를 초기화하는 생성자예요.
    def __init__(self, radius: float) -> None:
        self.radius = radius  # 인스턴스 변수에 반지름을 안전하게 저장해요.

    # 1. 인스턴스 메서드: self를 통해 자기 자신의 반지름(radius)을 가져와 넓이를 계산해요.
    def area(self) -> float:
        # 원의 넓이 = 파이 * 반지름의 제곱
        return Circle.pi * (self.radius ** 2)

    # 2. 클래스 메서드: @classmethod를 붙이고 첫 인자로 cls를 받아요.
    @classmethod
    def from_diameter(cls, diameter: float) -> 'Circle':
        # 지름(diameter)을 2로 나눠서 반지름으로 만든 뒤, 클래스(cls)를 호출해 새 원을 만들어요.
        return cls(diameter / 2) 

    # 3. 정적 메서드: @staticmethod를 붙이고 self나 cls 없이 일반 함수처럼 작동해요.
    @staticmethod
    def cm_to_mm(cm: float) -> float:
        # 원의 내부 데이터와 상관없이 단순히 센티미터를 밀리미터로 바꾸는 계산만 수행해요.
        return cm * 10

# 지름이 10인 원을 만들고 싶을 때 클래스 메서드를 쓰면 생성 의도가 아주 명확해져요.
c = Circle.from_diameter(10)
print(f"넓이: {c.area()}") # 출력: 넓이: 78.53975

💡 Tip

클래스 메서드를 사용해 다양한 방식으로 인스턴스를 생성하는 기법을 실무에서는 ‘팩토리 메서드 패턴’의 일종으로 흔히 사용해요. 생성자(__init__) 하나만으로는 표현하기 힘든 복잡한 생성 과정을 깔끔하게 정리할 수 있답니다.

# 공통 기능을 모아둔 듬직한 부모 클래스 Animal을 정의해요.
class Animal:
    # 동물의 기본 속성인 이름과 나이를 초기화해요.
    def __init__(self, name: str, age: int) -> None:
        self.name = name  # 이름을 저장해요.
        self.age = age    # 나이를 저장해요.

    # 동물이 소리를 내는 기본 메서드예요. 아직 어떤 동물인지 모르니 점만 찍어둘게요.
    def make_sound(self) -> str:
        return "..."

# Animal 클래스를 상속받는 자식 클래스 Cat을 만들어요. 상속받을 땐 괄호 안에 부모 이름을 쏙 적어요.
class Cat(Animal):
    # 고양이는 이름, 나이뿐만 아니라 품종(breed)이라는 고유 속성이 더 필요해요.
    def __init__(self, name: str, age: int, breed: str) -> None:
        # super()를 써서 부모의 __init__을 먼저 호출해 이름과 나이를 세팅해요.
        super().__init__(name, age)
        # 그런 다음 고양이만의 고유 속성인 품종을 추가로 저장해요.
        self.breed = breed 

    # 부모에게 물려받은 make_sound 메서드를 밋밋하지 않게 고양이식으로 덮어써요(오버라이딩).
    def make_sound(self) -> str:
        return "야옹~ Meow!"

# Cat 클래스로 luna 인스턴스를 만들어 소리를 들어볼까요?
luna = Cat("Luna", 2, "페르시안")
print(luna.make_sound()) # 출력: 야옹~ Meow!

⚠️ Warning

상속을 너무 깊게, 여러 단계로 엮어버리면 나중에는 이 메서드가 대체 어느 부모에게서 왔는지 추적하기가 불가능에 가까워져요. 실무에서는 상속의 깊이를 최대 1~2단계 정도로 얕게 유지하는 것을 강력히 권장합니다.

# 상품의 정보를 담고 재고를 철저히 관리하는 Product 클래스예요.
class Product:
    # 상품 이름과 초기 재고 수량을 받아 안전하게 초기화해요.
    def __init__(self, name: str, stock: int) -> None:
        self.name = name    # 상품 이름을 저장해요.
        self.stock = stock  # 현재 재고 수량을 저장해요.

    # 재고를 추가하는 메서드예요. 입고될 수량(amount)을 받아요.
    def add_stock(self, amount: int) -> None:
        if amount <= 0:
            print("입고 수량은 1개 이상이어야 해요!")
            return
        # 기존 재고에 정상적으로 입력받은 수량을 더해요.
        self.stock += amount
        print(f"📦 {self.name} {amount}개 입고 완료. (현재 재고: {self.stock})")

    # 재고를 차감하는 메서드예요. 고객이 구매할 수량(amount)을 받아요.
    def sell(self, amount: int) -> None:
        # 재고가 판매 수량보다 적으면 에러 메시지를 띄우고 판매를 단호하게 막아요.
        if self.stock < amount:
            print(f"🚨 재고가 부족해요! 남은 수량을 확인해주세요. (현재 재고: {self.stock})")
            return
        # 재고가 충분하면 판매 수량만큼만 정확하게 재고를 줄여요.
        self.stock -= amount
        print(f"💳 {self.name} {amount}개 판매 완료. (현재 재고: {self.stock})")

# 실수 1: 자식 클래스에서 상속받을 때 super()를 통째로 빼먹는 경우
class Dog(Animal):
    def __init__(self, name: str, age: int, breed: str):
        # 치명적 실수: 여기서 super().__init__(name, age)를 호출하지 않았어요.
        self.breed = breed
        # 이 상태에서 부모가 만들어주는 self.name을 쓰려고 하면 AttributeError가 빵 터져요!

# 실수 2: 인스턴스 메서드를 만들 때 self를 깜빡하는 경우
class Cat:
    # 앗, 첫 번째 매개변수로 지정석인 self를 적지 않았어요.
    def make_sound():  
        return "야옹"
    # 인스턴스를 만들고 cat.make_sound()를 호출하면 TypeError가 발생해요!
    # 파이썬은 항상 보이지 않게 첫 번째 인자로 인스턴스 자신을 던지기 때문이에요.

# 실수 3: 클래스 변수와 인스턴스 변수의 역할을 완전히 헷갈리는 경우
class Counter:
    count = 0  # 이건 클래스 변수라 이 클래스로 만든 모든 인스턴스가 1개의 데이터를 공유해요.
    
    def __init__(self):
        # 만약 각자 따로 놀아야 하는 독립적인 카운트를 원했다면 아래처럼 인스턴스 변수로 만들었어야 해요.
        self.my_count = 0 

❗ 중요

파이썬이 뱉어내는 에러 메시지의 마지막 줄을 읽는 습관을 들이세요. TypeError에 "takes 0 positional arguments but 1 was given"이라는 말이 보이면 100% self를 빼먹은 거랍니다.