Cómo crear un archivo y escribir en él en Java: guía completa con ejemplos

Creación de archivos y escritura en ellos en Java: lo entendemos de una vez por todas

La pregunta "How do I create a file and write to it?" es una de las más populares en Stack Overflow. Y no es de extrañar: trabajar con archivos es la base que todo desarrollador Java aprende. Pero el diablo, como siempre, está en los detalles. ¿Qué clase elegir? ¿Cómo no perder datos? ¿Cómo manejar las excepciones? En este artículo no solo daremos una respuesta preparada, sino que analizaremos todos los métodos populares, sus ventajas y desventajas, para que pueda trabajar con archivos en Java con confianza.

Veremos la creación de archivos y escritura en ellos en Java, desde los clásicos FileWriter y BufferedWriter hasta el moderno Files.writeString(). ¡Allá vamos!

1. Método clásico: FileWriter

La forma más simple e intuitiva de crear un archivo y escribir texto en él es usar java.io.FileWriter. Está diseñado específicamente para escribir flujos de caracteres.

¿Cómo funciona?

El constructor de FileWriter recibe el nombre del archivo (o un objeto File). Si el archivo no existe, se crea automáticamente. Si el archivo existe, se sobrescribe (a menos que se especifique la bandera append).

import java.io.FileWriter;\nimport java.io.IOException;\n\npublic class FileWriterExample {\n    public static void main(String[] args) {\n        try (FileWriter writer = new FileWriter("example.txt")) {\n            writer.write("¡Hola, mundo! Esta es la primera línea.\\n");\n            writer.write("Y esta es la segunda línea.");\n            System.out.println("¡Archivo creado y escrito exitosamente!");\n        } catch (IOException e) {\n            System.err.println("Error al trabajar con el archivo: " + e.getMessage());\n        }\n    }\n}\n

Importante: Usamos try-with-resources (Java 7+). Esto garantiza que el flujo se cierre automáticamente, incluso si ocurre una excepción. Olvidar cerrar FileWriter es uno de los errores más comunes de los principiantes.

¿Cuándo usar FileWriter?

\n
• Para escritura simple de archivos de texto pequeños.
\n
• Cuando no se requiere un alto rendimiento.
\n
• Para prototipado rápido.
\n

Desventajas

\n
• Ineficiente para escribir grandes volúmenes de datos (cada llamada a write() puede generar una llamada al sistema).
\n
• No admite especificar la codificación (usa la codificación predeterminada, lo que puede causar problemas en diferentes plataformas).
\n

2. Rendimiento y fiabilidad: BufferedWriter

Si necesita escribir muchos datos, use BufferedWriter. Este envuelve a FileWriter y agrega almacenamiento en búfer. Los datos se acumulan primero en el búfer y luego se escriben en el archivo en un solo bloque grande. Esto acelera significativamente la operación.

import java.io.BufferedWriter;\nimport java.io.FileWriter;\nimport java.io.IOException;\n\npublic class BufferedWriterExample {\n    public static void main(String[] args) {\n        String[] lines = {"Línea 1", "Línea 2", "Línea 3"};\n\n        try (BufferedWriter writer = new BufferedWriter(new FileWriter("buffered_example.txt"))) {\n            for (String line : lines) {\n                writer.write(line);\n                writer.newLine(); // Agrega un salto de línea, independientemente del SO\n            }\n            System.out.println("Archivo escrito a través de BufferedWriter.");\n        } catch (IOException e) {\n            System.err.println("Error: " + e.getMessage());\n        }\n    }\n}\n

Observe el método newLine(). A diferencia de \\n, utiliza el separador de línea del sistema, lo que hace que su código sea multiplataforma.

¿Cuándo usar BufferedWriter?

\n
• Para escribir archivos de texto grandes.
\n
• Cuando el rendimiento es importante
\n