Guía de diagnóstico

FileNotFoundError: Python no encuentra el archivo en la ruta que estás usando

Una ruta relativa depende del directorio de trabajo actual. El archivo puede existir en tu proyecto y aun así no estar donde el proceso lo está buscando.

Revisado 2026-09-30Ejemplos y diagnóstico

Haz visible la ruta que Python está resolviendo

rutas.py
from pathlib import Path

ruta = Path("datos.csv")
print(Path.cwd())
print(ruta.resolve())
print(ruta.exists())

Estas tres líneas responden mejor que “el archivo está en la carpeta”: muestran desde dónde se ejecuta el proceso y qué ruta absoluta resulta.

Comprueba estas causas en orden

  1. Nombre y extensión: datos.csv no es datos.CSV en todos los sistemas.
  2. Directorio de trabajo: ejecutar desde IDE, terminal o notebook puede cambiarlo.
  3. Ruta relativa: se resuelve respecto al proceso, no necesariamente respecto al archivo .py.
  4. Archivo creado: quizá esperabas un paso anterior que todavía no ocurrió.

pathlib hace explícita la intención

config.py
from pathlib import Path

base = Path(__file__).resolve().parent
ruta = base / "datos" / "config.json"

En un script local, construir rutas desde una base conocida suele ser más robusto que depender del directorio desde el que alguien lanzó el programa.

En el navegador hay otro sistema de archivos

El editor web usa un entorno WebAssembly aislado; no puede leer arbitrariamente los archivos de tu ordenador por una ruta como C:\... o /home/.... Reproduce ejemplos de archivos reales también en Python local.

Señal de que ya lo entiendesPuedes provocar este error con un ejemplo mínimo, explicar qué supuesto se rompió y elegir una corrección que conserve la intención del programa.

Referencia técnica: documentación oficial de excepciones de Python.