🐍 파이썬에서 isinstance vs issubclass 완벽 가이드

파이썬에서는 객체나 클래스의 타입을 확인할 때 isinstance와 issubclass를 자주 사용합니다.

두 함수는 비슷해 보이지만 확인하는 대상과 용도가 다릅니다.

이 글에서는 두 함수의 차이, 사용법, 비교를 초보자도 이해할 수 있도록 쉽게 설명하겠습니다.

---

✅ 1. isinstance(obj, classinfo) — 객체가 특정 클래스의 인스턴스인지 확인

📌 개념

• isinstance(객체, 클래스)
• 객체가 특정 클래스(또는 그 하위 클래스)의 인스턴스인지 검사.

🧩 기본 예제

class Animal: pass
class Dog(Animal): pass

dog = Dog()

print(isinstance(dog, Dog))      # ✅ True
print(isinstance(dog, Animal))   # ✅ True (Dog은 Animal의 하위 클래스)
print(isinstance(dog, object))   # ✅ True (모든 클래스는 object 상속)
print(isinstance(dog, str))      # ❌ False

✅ 특징

• 객체와 클래스 관계를 확인.
• 상속 관계도 인정 → 하위 클래스 인스턴스도 상위 클래스로 인정.

또한, 두 번째 인자로 타입 튜플을 넣으면 여러 타입 중 하나라도 일치하면 True를 리턴한다.

x = 42
print(isinstance(x, int))         # True
print(isinstance(x, (str, int)))  # True (int가 포함되어 있음)
print(isinstance(x, str))         # False

사용하는 이유로는 타입 검증 시 type(obj) == int보다 유연하며, 상속 관계까지 확인할 수 있기 때문이다.

---

✅ 2. issubclass(class, classinfo) — 클래스가 특정 클래스의 하위 클래스인지 확인

📌 개념

• issubclass(클래스, 클래스)
• 클래스가 다른 클래스의 하위 클래스인지 검사.

🧩 기본 예제

class Animal: pass
class Dog(Animal): pass

print(issubclass(Dog, Animal))   # ✅ True
print(issubclass(Animal, Dog))   # ❌ False
print(issubclass(Dog, object))   # ✅ True (모든 클래스는 object 하위)

✅ 특징

• 클래스 간 상속 관계를 확인.
• 첫 번째 인자는 반드시 클래스여야 한다.

---

✅ 3. 두 함수의 차이

구분	isinstance	issubclass
확인 대상	객체 vs 클래스	클래스 vs 클래스
반환 값	True / False	True / False
상속 관계	하위 클래스 인스턴스도 True	하위 클래스이면 True
예시	isinstance(dog, Animal) → True	issubclass(Dog, Animal) → True

---

✅ 4. 튜플로 여러 클래스 확인 가능

두 함수 모두 두 번째 인자에 클래스 튜플을 전달할 수 있습니다.

🧩 예제

class Animal: pass
class Dog(Animal): pass
class Cat(Animal): pass

dog = Dog()

# isinstance
print(isinstance(dog, (Dog, Cat)))    # ✅ True (Dog 포함)

# issubclass
print(issubclass(Dog, (Animal, str))) # ✅ True (Animal 포함)

---

✅ 5. 실전 사용 시 주의점

1. isinstance는 객체 확인용

2. issubclass는 클래스 확인용

3. type(obj) == Class 대신 isinstance(obj, Class) 사용

   • 이유: type()은 상속 관계를 고려하지 않음.

dog = Dog()
print(type(dog) == Animal)      # ❌ False
print(isinstance(dog, Animal))  # ✅ True

---

✅ 6. 실전 예제: 안전한 타입 검사

def process(animal):
    if isinstance(animal, Animal):
        print("동물 처리 중...")
    else:
        raise TypeError("Animal 또는 하위 클래스만 허용됩니다.")

process(Dog())    # ✅ 동물 처리 중...
process("cat")    # ❌ TypeError

---

🎯 정리

• ✅ isinstance(obj, Class)
  → 객체가 클래스(또는 하위 클래스) 인스턴스인지 확인

• ✅ issubclass(Class1, Class2)
  → Class1이 Class2의 하위 클래스인지 확인

• ✅ 사용 가이드

  • 객체 → isinstance
  • 클래스 → issubclass

---

💡 마무리

isinstance와 issubclass는 비슷하지만 용도가 다른 타입 검사 도구입니다.

• 객체의 타입 확인 → isinstance
• 클래스 간 상속 관계 확인 → issubclass

이제 타입 검사 시 언제 어떤 함수를 써야 할지 명확해졌을 것입니다.

---