HOWTO · Python
Como verificar se um arquivo existe em Python
Este artigo introduz como verificar se um arquivo existe em Python
Nesta página
A verificação de arquivo regular é útil quando a próxima etapa depende de o caminho apontar para um arquivo, e não para um diretório. Para um caminho pathlib, use Path.is_file(). O método retorna um valor booleano e segue links simbólicos até arquivos regulares. A verificação é apenas uma fotografia daquele momento: o caminho pode mudar antes de uma operação posterior. Por isso, abra o arquivo diretamente quando estiver pronto para usá-lo.
Resposta rápida: verifique se o caminho aponta para um arquivo
Execute este exemplo para verificar um arquivo regular criado pelo programa. O código e os rótulos exibidos permanecem em inglês:
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())
O diretório temporário mantém o exemplo autocontido. Path.is_file() é a opção mais direta quando a pergunta é especificamente se o caminho aponta para um arquivo regular. O resultado é True para um arquivo regular e False quando o caminho não existe, aponta para um diretório ou não é possível confirmar que aponta para um arquivo regular.
Use pathlib.Path.is_file()
pathlib representa caminhos do sistema de arquivos como objetos Path, então este método se encaixa no código que já usa pathlib. Crie um caminho a partir de uma string ou combine um caminho de diretório com um nome de arquivo usando /; em seguida, chame is_file(). O código e os rótulos exibidos permanecem em inglês:
from pathlib import Path
path = Path("reports") / "summary.txt"
if path.is_file():
print("A regular file is available.")
Este trecho mostra a verificação sem presumir que reports/summary.txt exista no ambiente do leitor. Ele não abre nem lê o arquivo. Erros de permissão ou do sistema operacional podem afetar o que a verificação consegue confirmar; por isso, não use um resultado falso para diagnosticar a causa de uma falha de acesso.
Use os.path.isfile()
No código que usa os.path, chame a função isfile() passando um caminho. Ela tem a mesma finalidade de verificar arquivos regulares que Path.is_file(). O código e os rótulos exibidos permanecem em inglês:
import os
path = os.path.join("reports", "summary.txt")
if os.path.isfile(path):
print("A regular file is available.")
os.path.isfile() é uma função, enquanto Path.is_file() é um método de um objeto Path. Escolha a forma que combina com o restante do código; ambas distinguem arquivos regulares de diretórios.
Escolha exists() quando diretórios também contam
Use Path.exists() ou os.path.exists() quando você só precisa saber se um caminho existe, seja ele um arquivo ou um diretório. Ambos podem retornar True para diretórios, portanto são mais abrangentes que uma verificação de arquivo regular. Por exemplo, use Path("reports").exists() quando um arquivo ou diretório nesse local for aceitável; use Path("reports").is_file() quando somente um arquivo regular servir.
Essas verificações não garantem que uma leitura ou gravação posterior terá sucesso. O caminho pode mudar depois da verificação, e a existência não comprova que seu processo tem permissão para usá-lo. Se o que importa é a própria operação, execute-a e trate os erros pertinentes.
Abra o arquivo diretamente quando for usá-lo
Se a próxima etapa for ler o arquivo, abri-lo diretamente evita depender de uma verificação que pode ficar desatualizada. Capture FileNotFoundError somente se quiser tratar um caminho ausente; deixe erros de permissão e outros erros de E/S visíveis ou trate-os separadamente, conforme a aplicação. O código e os rótulos exibidos permanecem em inglês:
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.")
Este padrão tenta fazer a leitura pretendida e trata especificamente a ausência do arquivo. Ele não interpreta PermissionError nem outro OSError como prova de que o caminho não existe. Use primeiro uma verificação quando precisar informar ou decidir com base no tipo do caminho; abra o arquivo diretamente quando sua intenção for lê-lo naquele momento.