Crear archivos de texto en Python

Escribir un archivo de texto en Python cabe en una línea. Lo que conviene saber es lo de alrededor: qué pasa si ya existe, cómo añadir sin borrar y por qué hay que decir siempre la codificación.

En una línea

from pathlib import Path

ruta = Path("salida") / "notas.txt"
ruta.parent.mkdir(parents=True, exist_ok=True)

ruta.write_text("Primera línea\nSegunda línea\n", encoding="utf-8")
print("escrito:", ruta.stat().st_size, "bytes")

salidaescrito: 30 bytes

Treinta bytes para veintiocho caracteres: cada «í» ocupa dos en UTF-8. write_text crea el archivo si no existe y lo vacía si existe. La barra / entre Path y cadenas une rutas y pone el separador correcto en cada sistema.

La forma clásica: open con with

with open("salida/lista.txt", "w", encoding="utf-8") as f:
    for i in range(1, 4):
        print("línea", i, file=f)

salida['línea 1', 'línea 2', 'línea 3']

El with cierra el archivo al salir del bloque, también si salta un error a mitad. La versión anterior de esta página llamaba a file.close() a mano, y si algo fallaba antes de llegar ahí, el archivo quedaba abierto y lo último escrito podía no llegar al disco. Y print(..., file=f) escribe en el archivo y pone el salto de línea por ti.

Añadir sin borrar

with ruta.open("a", encoding="utf-8") as f:
    f.write("Tercera línea\n")
print("tras añadir:", ruta.stat().st_size, "bytes")

salidatras añadir: 45 bytes

Los modos

with open("salida/notas.txt", "x", encoding="utf-8") as f:
    f.write("no debería")

salidaFileExistsError: salida/notas.txt

El modo "x" es el que hay que usar cuando sobrescribir sería un desastre: falla en vez de pisar.

Los saltos de línea: escribe \n, siempre

La versión anterior de esta página escribía "Primera línea" + os.linesep. Parece lo correcto y no lo es. En modo texto, Python ya convierte cada \n en el salto del sistema; en Windows, os.linesep vale \r\n, y su \n se convierte otra vez:

salidaos.linesep en modo texto, en Windows: b'a\r\r\n'

Un \r de más al final de cada línea. Lo simulamos aquí con newline="\r\n", que es lo que hace Python en Windows por debajo. La regla es sencilla: en modo texto, escribe \n y deja que Python se ocupe.

Más información en inglés: Create text files in Python.

Todo el código se ejecutó con Python 3.14 en un contenedor limpio antes de publicar esta página; las salidas están copiadas de esa ejecución.