Skill/기반기술
python] filename: Union[str, Path]
진열사랑
2025. 5. 22. 10:02
Python에서 다음과 같은 코드를 작성했을 때:
filename: str | Path
그리고 이런 에러가 발생한다면:
TypeError: unsupported operand type(s) for |: 'type' and 'type'
이는 Python 버전이 낮아서 | 기호를 타입 힌팅에 사용할 수 없기 때문에 발생한 에러입니다.
✅ 해결 방법
방법 1: Python 3.10 이상으로 업그레이드
str | Path와 같은 **타입 합집합 표기법(Union types with |)**은 Python 3.10 이상에서만 지원됩니다.
따라서 가장 좋은 해결 방법은 Python을 3.10 이상 버전으로 업그레이드하는 것입니다.
python --version
3.10 이상이 아니면 업그레이드가 필요합니다.
방법 2: Union을 사용하는 방식으로 변경 (Python 3.9 이하용)
Python 3.9 이하에서는 typing 모듈의 Union을 사용해야 합니다:
from typing import Union
from pathlib import Path
filename: Union[str, Path]
이렇게 바꾸면 Python 3.7, 3.8, 3.9에서도 작동합니다.
🔍 요약
코드 지원 Python 버전
`str | Path` |
Union[str, Path] | 3.9 이하 포함 가능 |
필요하시면 Python 버전 업그레이드 방법도 도와드릴 수 있어요.