HOWTO · Python

파이썬에 파일이 있는지 확인하는 방법

이 방법 기사는 파일이 파이썬에 존재하는지 확인하는 방법을 소개합니다

이 페이지의 내용

다음 작업에서 경로가 디렉터리가 아니라 파일을 가리키는지가 중요하다면 일반 파일인지 확인하는 것이 유용합니다. pathlib 경로에는 Path.is_file()를 사용하세요. 이 메서드는 불리언 값을 반환하며, 일반 파일을 가리키는 심볼릭 링크도 따라갑니다. 확인 결과는 그 시점의 상태일 뿐입니다. 이후 작업 전에 경로가 바뀔 수 있으므로 파일을 사용할 준비가 되면 바로 여세요.

빠른 답: 경로가 파일인지 확인하기

프로그램에서 만든 일반 파일인지 확인하려면 다음 예제를 실행하세요:

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

from pathlib import Path
from tempfile import TemporaryDirectory

with TemporaryDirectory() as folder:
    path = Path(folder) / "notes.txt"
    path.write_text("Hello, Python!", encoding="utf-8")
    print(path.is_file())

임시 디렉터리를 사용하므로 예제를 독립적으로 실행할 수 있습니다. 경로가 일반 파일을 가리키는지 확인하는 것이 목적이라면 Path.is_file()가 가장 명확한 선택입니다. 일반 파일이면 True를 반환하고, 경로가 없거나 디렉터리를 가리키거나 일반 파일인지 확인할 수 없으면 False를 반환합니다.

pathlib.Path.is_file() 사용하기

pathlib은 파일 시스템 경로를 Path 객체로 표현하므로, 이미 pathlib을 사용하는 코드에 이 메서드가 잘 어울립니다. 문자열로 경로를 만들거나 디렉터리 경로와 파일 이름을 /로 결합한 다음 is_file()을 호출하세요:

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

from pathlib import Path

path = Path("reports") / "summary.txt"
if path.is_file():
    print("A regular file is available.")

이 예제는 독자의 환경에 reports/summary.txt가 있다고 가정하지 않고 파일 여부를 확인합니다. 파일을 열거나 읽지는 않습니다. 예제의 A regular file is available. 문구는 코드와 함께 영어로 그대로 표시됩니다. 파일 시스템 권한이나 운영 체제 오류 때문에 확인 가능한 정보가 달라질 수 있으므로, 결과가 False라고 해서 접근에 실패한 이유를 단정하지 마세요.

os.path.isfile() 사용하기

os.path를 사용하는 코드에서는 경로를 인수로 전달해 isfile() 함수를 호출하세요. 일반 파일을 확인한다는 점에서 Path.is_file()와 같은 용도로 사용할 수 있습니다:

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import os

path = os.path.join("reports", "summary.txt")
if os.path.isfile(path):
    print("A regular file is available.")

os.path.isfile()는 함수이고 Path.is_file()는 Path 객체의 메서드입니다. 주변 코드에 맞는 방식을 선택하세요. 두 방식 모두 일반 파일과 디렉터리를 구분합니다. 예제의 A regular file is available. 문구는 코드와 함께 영어로 그대로 표시됩니다.

디렉터리도 존재하는 것으로 볼 때는 exists() 선택하기

경로가 파일인지 디렉터리인지에 관계없이 존재하는지만 확인하면 된다면 Path.exists() 또는 os.path.exists()를 사용하세요. 두 메서드 모두 디렉터리에 대해 True를 반환할 수 있으므로 일반 파일 확인보다 범위가 넓습니다. 예를 들어 해당 위치에 파일이나 디렉터리 중 어느 것이든 있으면 괜찮을 때는 Path("reports").exists()를 사용하고, 일반 파일만 허용할 때는 Path("reports").is_file()을 사용하세요.

이러한 확인만으로 나중에 읽기나 쓰기가 성공한다고 보장할 수는 없습니다. 확인한 뒤 경로가 바뀔 수 있고, 경로가 존재한다고 해서 현재 프로세스에 그 경로를 사용할 권한이 있다는 뜻도 아닙니다. 실제 작업의 성공 여부가 중요하다면 그 작업을 수행하고 관련 오류를 처리하세요.

파일을 사용할 때는 바로 열기

다음 단계가 파일 읽기라면 바로 열어 확인 결과가 오래되어 달라지는 문제를 피할 수 있습니다. 경로가 없을 때만 처리하려는 경우 FileNotFoundError를 잡으세요. 권한 오류나 그 밖의 입출력 오류는 그대로 드러나게 두거나 애플리케이션의 필요에 따라 따로 처리하세요:

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

from pathlib import Path

path = Path("settings.json")
try:
    with path.open(encoding="utf-8") as file:
        contents = file.read()
except FileNotFoundError:
    contents = None

if contents is None:
    print("The settings file is missing.")
else:
    print("The settings file was read.")

이 방식은 읽기를 시도하면서 파일이 없는 경우를 구체적으로 처리합니다. 예제에 출력되는 The settings file is missing. 및 The settings file was read. 문구는 코드와 함께 영어로 그대로 표시됩니다. PermissionError나 다른 OSError가 발생했다고 해서 경로가 없다고 간주하지 않습니다. 경로 종류를 보고하거나 그에 따라 분기해야 한다면 먼저 확인하는 방식을 사용하고, 지금 파일을 읽으려는 경우에는 바로 여세요.