여기서는 파일 내용을 읽는 것보다 경로를 문자열이 아니라 객체로 다루는가를 먼저 봅니다.
pathlib은 파일 I/O 카드이기 전에, 경로 조합과 존재 확인을 Path 객체 중심으로 읽는 카드에 가깝습니다.

빠른 흐름

from pathlib import Path

base_dir = Path("data")
file_path = base_dir / "users" / "list.txt"

file_path.parent.mkdir(parents=True, exist_ok=True)
file_path.write_text("mina\njin\n", encoding="utf-8")
content = file_path.read_text(encoding="utf-8")

기본 흐름

기본형은 Path(...), 경로 조합, 존재 확인, 텍스트 읽기/쓰기, 디렉터리 생성, open()까지 같이 보면 됩니다.

from pathlib import Path

root = Path("data")
config = root / "config.json"
exists = config.exists()
text = config.read_text(encoding="utf-8")
config.write_text(text, encoding="utf-8")
root.mkdir(parents=True, exist_ok=True)

with config.open("r", encoding="utf-8") as file:
    ...

Path 객체에 경로 정보와 파일 시스템 동작이 같이 모여 있기 때문에, 문자열 덧붙이기보다 경로 의도가 더 직접적으로 드러납니다.

경로 조합

경로를 이어 붙이면 Path(...) / "child"다

os.path.join()은 문자열을 계속 이어 붙여야 해서, 읽을 때 경로 조작이 잘 안 보일 수 있습니다. Path는 경로 자체를 객체로 표현해 줍니다.

from pathlib import Path

root = Path("logs")
log_file = root / "2026" / "app.log"

/ 연산자로 경로를 이어 붙이는 문법 덕분에 특히 깊은 경로를 만들 때 가독성이 좋습니다.

상태 확인

존재 확인과 타입 확인도 Path 메서드에서 바로 읽는다

파일 시스템 상태를 볼 때도 별도 문자열 유틸리티로 흩어지지 않고 Path 메서드로 읽을 수 있습니다.

path = Path("config.json")

if path.exists():
    print("exists")

if path.is_file():
    print("file")

즉 "이 경로가 무엇인가"와 "이 경로로 무엇을 할까"가 한 객체 주위에 모입니다.

텍스트 입출력

작은 텍스트 파일은 read_text()와 write_text()가 가장 짧다

작은 텍스트 파일은 open()을 직접 쓰지 않아도 read_text()와 write_text()만으로 충분한 경우가 많습니다.

config_path = Path("config.json")
raw = config_path.read_text(encoding="utf-8")

output = Path("result.txt")
output.write_text("done\n", encoding="utf-8")

파일 열기/닫기 패턴보다 훨씬 짧고, "텍스트냐 바이트냐"도 메서드 이름에서 바로 드러납니다.

디렉터리와 파일 객체

저장 전 parent.mkdir()와 더 복잡한 경우의 open()을 같이 본다

파일 저장 전 디렉터리가 없을 수 있다는 점까지 같이 보면 실전 코드가 됩니다.

report = Path("out/reports/daily.txt")
report.parent.mkdir(parents=True, exist_ok=True)
report.write_text("done\n", encoding="utf-8")

이 패턴은 리포트 저장, 캐시 파일 저장, 로그 파일 초기 생성에서 자주 보입니다.

JSON, CSV처럼 스트림 단위로 읽고 써야 하거나, with 블록 안에서 파일 객체가 필요한 경우는 결국 path.open()으로 이어집니다. 즉 작은 텍스트 파일은 read_text()와 write_text()로 충분하고, 더 복잡한 입출력은 path.open()으로 내려가면 됩니다.

from pathlib import Path

path = Path("data/users.txt")
with path.open("r", encoding="utf-8") as file:
    for line in file:
        print(line.strip())

즉 "한 번에 전체 문자열을 읽는다"면 read_text(), "파일 객체를 잡고 반복하거나 json/csv 라이브러리에 넘긴다"면 path.open()이라고 보면 됩니다.

주의할 점

# ❌ 환경 기본 인코딩에 의존
text = Path("note.txt").read_text()

# ✅ 명시적으로 UTF-8 사용
text = Path("note.txt").read_text(encoding="utf-8")

# ❌ 문자열 더하기로 경로를 합치면 구분자와 가독성이 불안정
root = "data"
file_path = root + "/users.txt"

# ✅ 경로 조합은 Path 객체에서 처리
root = Path("data")
file_path = root / "users.txt"