카테고리 없음

파이썬 ‘TypeError: cannot concatenate str and int’ 오류 해결하기

vibespace 2025. 5. 20. 19:55

파이썬에서 ‘TypeError: cannot concatenate str and int’ 오류란?

파이썬을 사용하다 보면 종종 마주하는 오류 중 하나가 바로 ‘TypeError: cannot concatenate str and int’입니다. 이 오류는 문자열(str)과 정수(int)를 더하려고 시도할 때 발생합니다. 파이썬에서는 두 자료형을 직접적으로 결합할 수 없기 때문에 이 오류가 발생하는 것입니다. 이 글에서는 이 오류의 원인과 해결 방법에 대해 자세히 설명하겠습니다.

‘TypeError: cannot concatenate str and int’ 오류 원인

‘TypeError: cannot concatenate str and int’ 오류는 문자열과 정수를 더하려고 할 때 발생합니다. 예를 들어, 다음과 같은 코드에서 이 오류가 발생할 수 있습니다:

name = "John"
age = 25
print(name + age)

위 코드는 문자열 ‘John’과 정수 25를 더하려고 시도하는데, 파이썬에서는 두 자료형이 다르기 때문에 오류가 발생합니다. 문자열과 정수를 결합하려면 먼저 두 자료형을 일치시켜야 합니다.

‘TypeError: cannot concatenate str and int’ 오류 해결 방법

이 오류를 해결하는 방법은 여러 가지가 있지만, 가장 일반적인 방법은 숫자(int)를 문자열(str)로 변환하는 것입니다. 이를 위해 str() 함수를 사용할 수 있습니다. 아래 예시를 확인해보세요:

name = "John"
age = 25
print(name + str(age))

위와 같이 str(age)로 숫자를 문자열로 변환한 후, 문자열끼리 더할 수 있습니다. 이렇게 하면 오류가 발생하지 않고 정상적으로 출력됩니다.

문자열과 숫자 결합을 위한 다른 방법들

문자열과 숫자를 결합하는 방법에는 str() 함수 외에도 몇 가지 방법이 있습니다. 이를 통해 코드의 가독성을 높일 수 있습니다.

1. f-string을 사용한 방법

파이썬 3.6 이상에서는 f-string을 사용하여 문자열과 변수를 쉽게 결합할 수 있습니다. 이 방법은 코드가 간결하고 가독성이 뛰어나기 때문에 매우 유용합니다:

name = "John"
age = 25
print(f"{name}은 {age}살입니다.")

이렇게 하면 변수들을 중괄호 안에 넣어 쉽게 문자열과 결합할 수 있습니다.

2. format() 메서드를 사용한 방법

format() 메서드는 문자열 내에서 자리 표시자({})를 사용하여 값을 삽입할 수 있습니다. 이 방법은 이전 버전의 파이썬에서도 사용할 수 있어 호환성이 좋습니다:

name = "John"
age = 25
print("{}은 {}살입니다.".format(name, age))

이 방법은 특히 다수의 변수를 결합할 때 유용합니다.

‘TypeError: cannot concatenate str and int’ 오류 예방하기

이 오류를 예방하려면 항상 변수의 자료형을 체크하고, 문자열과 숫자를 결합할 때 적절한 형변환을 해주는 것이 좋습니다. 또한, 코드를 작성할 때 자료형을 명확하게 지정하는 습관을 들이면 이러한 오류를 최소화할 수 있습니다.

결론

‘TypeError: cannot concatenate str and int’ 오류는 파이썬에서 문자열과 정수를 결합하려고 할 때 발생하는 흔한 오류입니다. 이 오류를 해결하려면 숫자를 문자열로 변환하거나, f-string 또는 format() 메서드를 사용하여 문자열을 결합할 수 있습니다. 이러한 방법들을 통해 오류를 쉽게 해결하고, 코드의 가독성을 높일 수 있습니다.