파이썬에서 텍스트 파일을 UTF-8로 읽다가 UnicodeDecodeError가 나면, 원본을 다시 저장하기 전에 복사본에서 읽기만 시도하세요. 이 오류는 지정한 방식으로 일부 바이트를 글자로 바꾸지 못했다는 뜻입니다. 파일의 실제 인코딩을 오류 하나만으로 확정할 수는 없고, errors="replace"로 보이는 기호도 원래 글자를 복구한 결과가 아닙니다.
아래는 2026년 9월 29일 macOS의 Python 3.14.4에서 직접 실행한 연습입니다. 임시 폴더에 정상 UTF-8 파일 하나와 일부러 잘못된 바이트가 든 파일 하나를 만듭니다. 받은 파일이나 개인 문서는 열거나 바꾸지 않습니다. Python의 공식 Path.read_text() 문서는 읽을 때 encoding과 errors를 지정할 수 있다고 설명합니다.
두 임시 파일로 차이를 확인하세요
아래 코드를 check_utf8.py로 저장하고 그 폴더에서 python3 check_utf8.py를 실행하세요. Windows에서는 설치된 Python 실행 명령이 py일 수 있습니다. TemporaryDirectory() 안에 만든 연습 파일은 실행이 끝나면 삭제됩니다.
from pathlib import Path
from tempfile import TemporaryDirectory
with TemporaryDirectory() as folder:
normal = Path(folder) / "normal.txt"
invalid = Path(folder) / "invalid.txt"
normal.write_bytes("한글 메모".encode("utf-8"))
invalid.write_bytes(b"\xff") # UTF-8로 해석할 수 없는 연습 바이트
for path in (normal, invalid):
try:
text = path.read_text(encoding="utf-8")
except UnicodeDecodeError:
print(f"{path.name}: UTF-8 읽기 실패")
else:
print(f"{path.name}: {text}")
replaced = invalid.read_text(encoding="utf-8", errors="replace")
print(f"invalid.txt 치환 표시: {replaced}")
write_bytes()는 연습 파일을 만들기 위한 부분입니다. 자신의 파일에 곧바로 이 코드를 적용할 때는 그 줄을 복사하지 마세요. read_text()는 파일 내용을 읽으며 이 예제에서 원본 바이트를 바꾸지 않습니다.
세 출력에서 무엇을 알 수 있나요?
normal.txt: 한글 메모
invalid.txt: UTF-8 읽기 실패
invalid.txt 치환 표시: �
첫 파일은 한글 메모를 UTF-8 바이트로 만든 뒤 같은 UTF-8로 읽어 원문이 나옵니다. 두 번째 파일의 0xff 한 바이트는 이 연습에서 UTF-8 글자로 해석할 수 없어 오류 분기로 갑니다. 이 결과만으로 실제로 받은 파일이 어떤 다른 인코딩인지 알 수는 없습니다.
마지막 줄의 �는 errors="replace"가 해석할 수 없는 바이트 자리에 넣은 치환 문자입니다. Python open() 문서는 errors가 디코딩 오류 처리 방식을 정한다고 설명합니다. 화면을 임시로 살펴볼 때만 쓸 수 있지만, 치환한 내용을 원본 위에 저장하면 원래 바이트를 되살리는 데 필요한 정보가 없어질 수 있습니다. 따라서 이 글의 코드는 치환된 내용을 저장하지 않습니다.
자기 파일에 적용할 때
먼저 원본 파일을 별도 위치에 복사하세요. 그 복사본의 경로를 확인한 뒤 Path("복사본.txt").read_text(encoding="utf-8")로 읽기만 시도합니다. 경로를 잘못 쓰면 파일을 못 찾는 다른 오류가 나오므로, 이때는 인코딩보다 파일 위치를 먼저 확인하세요. 예제의 invalid.txt는 어느 실제 문서 형식도 대표하지 않는 한 바이트짜리 인공 입력입니다.
복사본에서도 UnicodeDecodeError가 나면 파일을 준 사람이나 원래 저장한 앱에서 인코딩을 확인하세요. 다른 인코딩을 무작정 바꿔 넣으면 오류 없이 읽혀도 글자가 틀릴 수 있습니다. 정상 파일은 원문이 나오고, 잘못된 연습 파일은 실패 안내와 치환 표시가 따로 나오면 실습이 끝난 것입니다. 자신의 파일은 출처에서 인코딩을 확인할 때까지 원본을 보존하세요. 파일 읽기 자체가 다른 오류로 멈췄다면 파이썬 오류 메시지의 마지막 줄을 읽는 순서로 원인 위치부터 확인해 보세요.