Programación

Leer y escribir archivos en Python: open(), modos y la instrucción with

Los modos de open(), cómo leer línea a línea, escribir con write() y por qué usar with para cerrar el archivo.

Enviar por WhatsApp

Leer y escribir archivos es una de las primeras cosas útiles que se hacen en Python: guardar resultados, leer una lista de datos o procesar un texto. Todo parte de la función open(). Esta guía sigue el tutorial oficial de Python.

Los modos de apertura más usados.Para leer o escribir: 'r' solo lectura (por defecto); 'w' solo escritura: borra lo anterior; 'a' añade al final; 'r+' lectura y escritura. Texto o binario: Texto: lees y escribes cadenas; Con 'b' se abre en modo binario; El binario usa bytes, no texto; Imágenes o programas: modo binarioCOMPARATIVAPara leer o escribir'r' solo lectura (por defecto)'w' solo escritura: borra loanterior'a' añade al final'r+' lectura y escrituraTexto o binarioTexto: lees y escribes cadenasCon 'b' se abre en modo binarioEl binario usa bytes, no textoImágenes o programas: modobinario
Los modos de apertura más usados.

Abrir un archivo

open() devuelve un objeto archivo y se usa normalmente con dos argumentos: open(nombre_de_archivo, modo). El primero es una cadena con el nombre del archivo; el segundo, otra cadena con unos pocos caracteres que describen cómo se va a usar:

Modo Qué hace
'r' Solo lectura. Es el valor por defecto si omites el modo
'w' Solo escritura. Un archivo existente con el mismo nombre se borra
'a' Abre para agregar: lo que escribes se añade al final
'r+' Lectura y escritura

Por defecto los archivos se abren en modo texto: lees y escribes cadenas, codificadas con una codificación concreta. Si no indicas encoding, el valor por defecto es UTF-8. Añadiendo una b al modo, el archivo se abre en modo binario, en el que los datos se leen y escriben como objetos bytes (y no puedes indicar una codificación).

En modo texto, Python convierte los finales de línea propios de cada plataforma (\n en Unix, \r\n en Windows) a un simple \n al leer, y al revés al escribir. Está bien para texto, pero corrompería datos binarios como los de un JPEG o un EXE: para esos archivos, usa el modo binario.

La instrucción with

El tutorial recomienda abrir los archivos con with, porque el archivo se cierra correctamente al terminar el bloque, incluso si se produce una excepción, y es más corto que un try-finally:

with open('workfile') as f:
    read_data = f.read()
# Fuera del bloque, f.closed es True

Si no usas with, debes llamar a f.close() para cerrar el archivo y liberar los recursos. Python avisa de que llamar a f.write() sin with ni f.close() puede hacer que lo escrito no llegue por completo al disco, aunque el programa termine bien. Y una vez cerrado, intentar usar el archivo falla con ValueError: I/O operation on closed file.

La forma recomendada de abrir un archivo.with open('workfile') as f: | read_data = f.read() | # Aquí el archivo ya se ha cerradoEN LA TERMINALPythonwith open('workfile') as f:read_data = f.read()# Aquí el archivo ya se ha cerrado
La forma recomendada de abrir un archivo.

Leer

  • f.read() lee todo el contenido y lo devuelve como una cadena. Con un número, f.read(size), lee como máximo esa cantidad de caracteres (o de bytes en binario). El tutorial avisa: si omites el tamaño, el archivo entero se carga en memoria, y es cosa tuya que no sea más grande que ella. Al llegar al final devuelve una cadena vacía.
  • f.readline() lee una sola línea, con su \n al final. Si devuelve una cadena vacía, se ha llegado al final del archivo; una línea en blanco es '\n'.
  • Recorrer el archivo con un bucle for es la forma que el tutorial destaca como eficiente en memoria, rápida y más sencilla:
for line in f:
    print(line, end='')
  • Para leer todas las líneas en una lista puedes usar list(f) o f.readlines().

Escribir

f.write(cadena) escribe la cadena en el archivo y devuelve cuántos caracteres escribió. Otros tipos de objeto hay que convertirlos antes: a cadena en modo texto o a bytes en modo binario, por ejemplo con str(valor).

Buenas prácticas con archivos.Sí: Usa with para cerrarlos solos. Sí: Elige el modo adecuado. Sí: Usa el modo binario para JPEG o EXE. No: Abrir con 'w' un archivo que quieres conservarLISTA RÁPIDAAl trabajar con archivosUsa with para cerrarlos solosElige el modo adecuadoUsa el modo binario para JPEG o EXEAbrir con 'w' un archivo que quieres conservar
Buenas prácticas con archivos.

Si algo falla

Abrir un archivo que no existe, o sin permisos, produce un error. Aprende a leerlo y a gestionarlo en errores y excepciones en Python. Si empiezas desde cero, antes tienes la guía para instalar Python y escribir tu primer programa, y para organizar lo que lees, las listas y diccionarios y las funciones. Si lo que lees es JSON, puedes revisarlo antes con el formateador de JSON.