파이썬 파일입출력 완벽 가이드, Windows 긴 경로(Path) 지원 예제까지 정리

📂 파이썬 파일입출력의 기본 개념

파이썬에서 파일을 다루는 기본은 open() 함수를 사용하는 것입니다.
파일을 열 때는 모드(mode)를 지정해야 하며, 읽기 전용으로 열지, 쓰기 전용으로 열지, 혹은 추가 모드로 열지를 선택할 수 있습니다.
이때 모드 값으로는 보통 r(읽기), w(쓰기), a(추가), b(바이너리) 등을 조합해서 사용합니다.

예를 들어 open("data.txt", "r")라고 입력하면 텍스트 파일을 읽기 전용으로 열게 됩니다.
파일을 열었다면 반드시 close() 메서드를 호출해 파일 리소스를 정리하는 것이 중요합니다.
하지만 매번 close()를 호출하는 것이 번거롭기 때문에, 파이썬에서는 with 구문을 사용하는 것이 일반적입니다.

# 파일 열기와 자동 닫기 예제
with open("example.txt", "r", encoding="utf-8") as f:
    content = f.read()
    print(content)

위 코드에서는 with open() 구문을 사용했기 때문에 블록이 끝나면 자동으로 파일이 닫힙니다.
따라서 별도의 close() 호출이 필요하지 않아 코드가 훨씬 깔끔해지고, 파일을 제대로 닫지 않아 생길 수 있는 리소스 누수 문제도 방지할 수 있습니다.

결국 파일입출력의 핵심은 어떤 모드로 파일을 열고, 어떻게 안전하게 닫느냐에 있습니다.
이 기본기를 이해하고 있어야 이후에 다룰 바이너리 파일 처리나 Windows 긴 경로 문제 해결도 한결 수월해집니다.

📝 텍스트 파일 읽기와 쓰기 예제

텍스트 파일은 가장 많이 사용하는 파일 형식입니다.
파이썬에서는 텍스트 파일을 쉽게 읽고 쓸 수 있는 다양한 메서드를 제공하고 있어, 로그 저장, 데이터 기록, 설정 파일 관리 등 여러 작업에 활용됩니다.

읽기 작업의 경우 read(), readline(), readlines() 등을 활용할 수 있습니다.
쓰기 작업은 write() 또는 writelines() 메서드로 수행할 수 있습니다.

# 텍스트 파일 쓰기 예제
with open("sample.txt", "w", encoding="utf-8") as f:
    f.write("첫 번째 줄입니다.\n")
    f.write("두 번째 줄입니다.\n")

# 텍스트 파일 읽기 예제
with open("sample.txt", "r", encoding="utf-8") as f:
    lines = f.readlines()
    for line in lines:
        print(line.strip())

위 예제에서는 두 줄의 문자열을 파일에 기록한 후, 다시 파일을 읽어서 한 줄씩 출력하는 과정을 보여줍니다.
strip() 메서드를 활용하면 각 줄 끝의 개행 문자를 제거할 수 있어 깔끔하게 데이터를 다룰 수 있습니다.

• 🛠️write()는 문자열 단위로 기록
• ⚙️writelines()는 리스트 형태로 여러 줄 기록
• 🔌파일을 읽을 때는 readlines()를 자주 사용

텍스트 파일 입출력은 단순해 보이지만, 줄 단위 처리와 인코딩 설정 여부에 따라 결과가 달라질 수 있습니다.
따라서 코드 작성 시 항상 일관된 인코딩을 지정하고, 필요한 경우 줄 끝 처리를 신경 쓰는 습관이 필요합니다.

💾 바이너리 파일 처리 방법

텍스트 파일과 달리 이미지, 동영상, 실행 파일처럼 바이너리 데이터를 다룰 때는 파일을 바이너리 모드로 열어야 합니다.
이를 위해 모드에 b를 함께 지정하면 되며, 예를 들어 "rb"(읽기), "wb"(쓰기), "ab"(추가) 형태로 사용합니다.

바이너리 파일을 다룰 때는 텍스트 인코딩을 지정하지 않으며, 데이터를 bytes 형태로 읽고 씁니다.
따라서 텍스트와 달리 줄 단위 처리 대신 버퍼 단위로 데이터를 다루는 경우가 많습니다.

# 이미지 파일 복사 예제
with open("image.png", "rb") as src:
    data = src.read()

with open("copy.png", "wb") as dst:
    dst.write(data)

위 예제는 이미지 파일을 읽어서 그대로 복사하는 간단한 코드입니다.
읽을 때는 "rb" 모드를 사용하고, 쓸 때는 "wb" 모드를 사용해야 파일이 손상되지 않습니다.

💬 바이너리 파일을 텍스트 모드로 열면 인코딩 오류가 발생하거나 파일이 깨질 수 있습니다. 특히 이미지, 압축 파일, 실행 파일은 반드시 바이너리 모드로 열어야 합니다.

• 📂rb: 읽기 전용 바이너리 모드
• ✍️wb: 쓰기 전용 바이너리 모드
• ➕ab: 기존 파일 끝에 데이터 추가

바이너리 파일을 다룰 때는 데이터가 사람이 읽을 수 있는 형태가 아니기 때문에 디버깅 과정에서 어려움이 생길 수 있습니다.
따라서 반드시 크기 단위로 데이터를 확인하거나, 헥사 뷰어 같은 툴을 함께 사용하는 것이 좋습니다.

⚙️ 파일 경로와 os, pathlib 활용

파이썬으로 파일 작업을 할 때 가장 자주 부딪히는 문제 중 하나는 파일 경로 처리입니다.
운영체제마다 경로 구분자가 다르고, 상대 경로와 절대 경로 개념이 혼재하기 때문에 코드가 예상대로 동작하지 않는 경우가 많습니다.

파이썬에서는 os 모듈과 pathlib 모듈을 이용해 경로 문제를 해결할 수 있습니다.
특히 pathlib은 객체 지향적으로 경로를 다룰 수 있어서 최근에는 더 많이 활용되고 있습니다.

📌 os 모듈로 경로 다루기

import os

# 현재 작업 디렉터리 확인
print(os.getcwd())

# 경로 합치기
path = os.path.join("C:\\Users", "Documents", "example.txt")
print(path)

os 모듈은 경로를 문자열로 다루기 때문에 간단하지만, 경로를 직접 조립할 때는 실수가 생길 수 있습니다.
윈도우와 리눅스의 구분자 차이 때문에 호환성 문제가 발생하기도 하죠.

📌 pathlib 모듈로 경로 다루기

from pathlib import Path

# 현재 작업 디렉터리
print(Path.cwd())

# 경로 합치기
file_path = Path("C:/Users") / "Documents" / "example.txt"
print(file_path)

pathlib은 경로를 객체로 관리하기 때문에 코드 가독성이 높고, 운영체제별 차이를 신경 쓰지 않아도 된다는 장점이 있습니다.
또한 .exists(), .is_file(), .mkdir() 같은 메서드도 제공되어 디렉터리 및 파일 작업을 훨씬 직관적으로 수행할 수 있습니다.

정리하자면, 단순 작업에는 os 모듈도 충분히 쓸 수 있지만, 프로젝트가 커지고 다양한 플랫폼을 지원해야 한다면 pathlib을 적극적으로 활용하는 것이 바람직합니다.

📌 Windows 긴 경로 지원 예제

Windows 운영체제에는 오랫동안 MAX_PATH라는 제한이 있었습니다.
경로 길이가 260자를 초과하면 파일을 열거나 저장할 때 오류가 발생하곤 했죠.
이 문제는 특히 자동으로 파일 이름을 생성하거나, 폴더 구조가 깊어지는 프로젝트에서 자주 나타났습니다.

파이썬에서는 경로 앞에 “\\\\?\\” 접두사를 붙여 이 문제를 해결할 수 있습니다.
즉, Path("\\\\?\\C:\\long\\...")와 같은 방식으로 경로를 지정하면 260자를 넘는 긴 경로도 정상적으로 처리할 수 있습니다.

from pathlib import Path

# Windows 긴 경로 예제
long_path = Path(r"\\\\?\\C:\\long\\nested\\directory\\structure\\very_long_filename.txt")

with open(long_path, "w", encoding="utf-8") as f:
    f.write("이 파일은 긴 경로를 지원합니다.")

with open(long_path, "r", encoding="utf-8") as f:
    print(f.read())

위 예제에서는 pathlib.Path 객체를 이용해 긴 경로를 지정했습니다.
이 방식은 Windows 10 이상에서 긴 경로 지원 옵션이 활성화되어 있어야 정상적으로 동작합니다.

긴 경로 지원을 켜기 위해서는 Windows 설정에서 “Win32 긴 경로 사용 가능” 옵션을 활성화해야 하며, 이는 그룹 정책 편집기(gpedit.msc)나 레지스트리 편집기를 통해 조정할 수 있습니다.
개발 환경에서 긴 경로를 다룰 일이 잦다면 반드시 이 설정을 켜 두는 것이 좋습니다.

❓ 자주 묻는 질문 (FAQ)