Cómo comprobar si un archivo existe en Python

Comprobar si un archivo existe es algo habitual en cualquier script de Python. Las tareas de automatización suelen depender de archivos de configuración, registros, instaladores o archivos de salida que pueden estar o no presentes en tiempo de ejecución. Python pone a disposición de los MSP métodos directos para verificar la presencia de un archivo de forma limpia y predecible. Conocer estos métodos ayuda a reducir errores y a mejorar la fiabilidad de tus scripts.

Puedes usar Python para comprobar si un archivo existe y, con ello, validar requisitos previos antes de ejecutar una tarea, evitar sobrescribir archivos importantes, confirmar que la salida se generó correctamente y controlar el flujo del script en tus pipelines de automatización.

Guía para validar archivos en Python

📌Requisitos previos:

• Necesitas tener Python instalado en tu sistema.
• Necesitas conocer, al menos de forma básica, la sintaxis de Python.
• Necesitas tener acceso al sistema de archivos que quieres comprobar.
• Necesitas saber, a grandes rasgos, la diferencia entre rutas relativas y absolutas.

Método 1: usar os.path.exists()

Es el método más básico para comprobar si algo existe en tu directorio. Te indica si allí hay un archivo, un directorio o un enlace simbólico.

import os

if os.path.exists("example.txt"):
                print("Path exists")
else:
                print("File does not exist")

Sustituye «Example.txt» por el archivo que estés buscando.

💡Nota: import os importa el módulo OS integrado en Python, que te permite interactuar con el sistema operativo desde Python. Si ya lo has importado, puedes eliminar esta línea del código.

Método 2: usar os.path.isfile() para comprobar solo archivos

Si solo quieres saber si existe un archivo, puedes usar este código:

import os

if os.path.isfile("example.txt"): 
            print("Path exists")
else:

           print("File does not exist")

Sustituye «Example.txt» por el archivo que estés buscando.

💡Nota: import os importa el módulo OS integrado en Python, que te permite interactuar con el sistema operativo desde Python. Si ya lo has importado, puedes eliminar esta línea del código.

Método 3: usar pathlib.Path.exists()

pathlib es un módulo integrado en Python que ofrece una forma orientada a objetos de trabajar con rutas del sistema de archivos. Al tratar las rutas como objetos con métodos útiles, resulta más limpio y eficiente que los métodos anteriores.

from pathlib import Path

file_path = Path("example.txt")
if file_path.exists():
             print("Path exists")
else:

            print("Path does not exist")

Sustituye «Example.txt» por el archivo que estés buscando.

💡Nota: esto solo te indica si una ruta existe. No distingue entre un archivo, un directorio o un enlace.

💡Nota: import Path importa el módulo OS integrado en Python, que te permite interactuar con el sistema operativo desde Python. Si ya lo has importado, puedes eliminar esta línea del código.

Distinguir archivos y directorios con pathlib

file_path.exists() solo te confirma que una ruta de archivo existe. No distingue entre archivos, rutas o directorios. Si quieres hacer esa distinción, usa los siguientes comandos:

• .is_file() – comprueba únicamente archivos en tu sistema.
• .is_dir() – comprueba únicamente directorios en tu sistema.

Evita comprobar la existencia de archivos mediante excepciones

También puedes comprobar la existencia de un archivo en Python con excepciones, así:

try:
     with open("example.txt") as f:
          data = f.read()
except FileNotFoundError:
       print("File does not exist")

Sin embargo, este enfoque puede resultar más complicado y difícil de leer. Las comprobaciones basadas en excepciones deberían reservarse para fallos inesperados. En el resto de los casos, lo mejor es empezar con comprobaciones de existencia si quieres mejorar la legibilidad y la previsibilidad de tu código.

Otros aspectos a tener en cuenta al comprobar si un archivo existe en Python

• Las rutas relativas dependen del directorio de trabajo del script.
• Los enlaces simbólicos pueden comportarse de forma distinta según cómo los analices.
• Los permisos de archivo pueden limitar el acceso aunque el archivo exista. Asegúrate de tener acceso a todo el directorio cuando realices estas comprobaciones.
• Los sistemas de archivos en red pueden presentar latencia o almacenamiento en caché, lo que puede afectar a los resultados que obtengas.
• La distinción entre mayúsculas y minúsculas varía según el sistema operativo. Tenlo en cuenta al ejecutar tus comandos de Python.

Resolución de problemas al validar archivos en Python

Problema	Solución
El archivo existe, pero Python dice que no.	Comprueba que has introducido correctamente la ruta y el directorio del archivo.
El script se comporta de forma distinta en otro SO.	Revisa los separadores de ruta y la distinción entre mayúsculas y minúsculas.
Recibes errores de permisos al comprobar la existencia de un archivo.	Asegúrate de contar con los derechos de acceso adecuados.
Te encuentras con condiciones de carrera.	Puede que el archivo que buscas se haya eliminado o se haya creado durante las comprobaciones de existencia.
Tus automatizaciones fallan.	Documenta las rutas y las comprobaciones para ganar visibilidad.

Aprovecha al máximo tus scripts de Python con las herramientas de NinjaOne

El conjunto de herramientas de NinjaOne facilita la automatización basada en Python, ya que permite a los MSP ejecutar scripts que validan la presencia de archivos antes de la ejecución. Las comprobaciones de existencia sirven para confirmar que un instalador está disponible, verificar archivos de configuración o asegurarte de que se generaron las salidas del script. Junto con el scripting y los informes centralizados, esto mejora la fiabilidad en todos los endpoints gestionados.

Saca más partido a tus scripts de Python con las comprobaciones de existencia

Comprobar si un archivo existe es un paso básico, pero crítico, para escribir scripts de Python fiables. Con métodos de la biblioteca estándar como os.path y pathlib, los desarrolladores y los equipos de TI pueden evitar errores innecesarios y crear flujos de automatización predecibles. Elegir el método adecuado según el tipo de archivo y el contexto garantiza que los scripts funcionen correctamente en cualquier entorno.

Artículos relacionados:

• Guía completa: cómo usar un script de Linux para comprobar si existe un archivo o una carpeta Cómo restringir el acceso a Python en Microsoft Excel con PowerShell
• Cómo usar un script de PowerShell para comprobar si existe un archivo o una carpeta en Windows
• Cómo automatizar las comprobaciones de existencia de archivos y carpetas en macOS
• Cómo usar PowerShell para verificar el hash de archivos en seguridad TI