//NextPatch
Perfil

Java 17 → 21: el salto entre LTS · UTF-8 por defecto

UTF-8 por defecto en Java 18: qué cambia en FileReader y Files

Cargando la lección…

Guarda tu racha: crea tu cuenta

Este reto se sumará a tu cuenta nueva: su XP y tu primer día de racha. Luego, uno nuevo cada día para preparar tu próxima entrevista.

Es un cambio de Java 18 (JEP 400), pero si saltas de Java 17 a Java 21 te lo encuentras igual: el charset por defecto de las API estándar pasa a ser UTF-8, siempre, en cualquier sistema operativo y configuración regional.

El problema que resuelve

Antes, Charset.defaultCharset() dependía del entorno: UTF-8 en macOS, pero windows-1252 o windows-31j en Windows. Un fichero escrito en una máquina y leído en otra se corrompía en silencio: el lector no tenía forma de saber que estaba decodificando mal, y las tildes se convertían en caracteres raros.

A qué API afecta

Todo lo que no recibe un charset explícito: FileReader, FileWriter, InputStreamReader, OutputStreamWriter, PrintStream, Formatter, Scanner o new String(bytes). Desde Java 18 todos usan UTF-8 si no les dices otra cosa.

Las dos excepciones

  • System.out y System.err usan el charset de la consola (Console.charset()), no el valor por defecto.
  • Los métodos de java.nio.file.Files sin charset, como readString o writeString, siempre fueron UTF-8, desde antes del JEP 400. Cambiar el valor por defecto no les afecta.

Si tus ficheros no son UTF-8

Hazlo explícito. Un fichero se lee con el mismo charset con el que se escribió:

java
Files.writeString(path, texto, StandardCharsets.ISO_8859_1);
String leido = Files.readString(path, StandardCharsets.ISO_8859_1);

Escribir StandardCharsets.UTF_8 aunque sea el valor por defecto también tiene sentido: el código dice lo que hace y no depende de cómo se arranque la JVM. Para aplicaciones antiguas que necesiten el comportamiento previo mientras migran existe -Dfile.encoding=COMPAT, pero es una muleta temporal, no una solución.