IA en tu dispositivo: profesional y privado.

Documentos

Cómo ordenar claves JSON alfabéticamente online (también los objetos anidados)

Ordena las claves JSON alfabéticamente online, en todos los niveles o solo en el primero. Un orden estable ayuda en diffs y revisiones, y qué ocurre con arrays y números.

Actualizado el 8 de noviembre de 202610 min de lectura

Para ordenar claves JSON alfabéticamente online, abre el ordenador de claves JSON, suelta un archivo .json o pega el texto, deja el orden en Alfabético y pulsa Ordenar claves. Cada objeto del documento, por muy anidado que esté, vuelve con sus claves de la A a la Z. Los arrays conservan su orden salvo que pidas lo contrario, y los valores se copian carácter por carácter, así que lo único que cambia es el orden de las claves y la sangría. El resto de esta guía explica para qué sirve, cuándo conviene ordenar solo el primer nivel y los pocos casos que sorprenden a la gente.

Por qué ordenar las claves JSON alfabéticamente

Un objeto JSON es, por definición, un conjunto no ordenado de nombres y valores. El estándar deja el orden de las claves en manos de quien escribe el archivo, de modo que dos programas que exportan los mismos datos pueden producir las claves en órdenes distintos: el orden en que la base de datos devolvió las columnas, el orden en que un desarrollador fue añadiendo campos con los años o el orden que una librería usa internamente. Los datos son idénticos. El texto, no.

Esa diferencia importa en cuanto una persona o una herramienta que trabaja por líneas lee el archivo. Ordenar las claves da a cada exportación una forma predecible, y eso ayuda en tres situaciones cotidianas:

  • Diffs en el control de versiones. Cuando un archivo de configuración se regenera con las claves revueltas, un diff por líneas marca medio archivo como cambiado. Con las claves ordenadas, el diff muestra solo las líneas cuyos valores cambiaron de verdad.
  • Revisiones de código. Quien busca timeout en un archivo de ajustes de 300 líneas lo encuentra siempre en el mismo sitio, y una clave duplicada o mal escrita queda justo al lado de su gemela correcta, donde salta a la vista.
  • Salida estable. Las cachés, las sumas de verificación y las pruebas de instantáneas que comparan archivos byte a byte fallan cuando lo único que cambió es el orden. Un archivo ordenado y con sangría uniforme produce los mismos bytes para los mismos datos.

Si solo necesitas ver qué cambió entre dos versiones, no hace falta ordenar antes: una comparación estructural ya ignora el orden de las claves, como se explica en cómo comparar dos archivos JSON. Ordenar sirve cuando el propio archivo tiene que guardarse en un repositorio, revisarse o publicarse con una forma estable.

Ordenar claves JSON paso a paso

1

Añade tu JSON

Suelta un archivo .json, .jsonc, .ndjson o .jsonl en el ordenador de claves JSON, búscalo con el botón o pega el texto en el cuadro que hay debajo de la zona de carga.

2

Elige el orden

Alfabético es la opción predeterminada y la que esperan la mayoría de las herramientas de diff y guías de estilo. Elige Natural si tus claves van numeradas, Longitud de clave para poner primero las cortas o Por valor para ordenar los miembros según lo que contienen. En Dirección, elige A → Z o Z → A.

3

Decide la profundidad

Deja Profundidad en Todos los niveles para ordenar cada objeto anidado, o elige Solo el primer nivel, 2 niveles o 3 niveles para conservar el orden interior tal como está escrito.

4

Abre Avanzado si lo necesitas

Fija claves arriba, decide qué ocurre con las claves duplicadas, ordena arrays o activa Aceptar comentarios y comas finales para archivos JSONC.

5

Ordena y guarda

Pulsa Ordenar claves, elige 2 espacios, 4 espacios, tabulación o salida minificada, y descarga el archivo o cópialo. Si cambias un ajuste después, el resultado se marca como hecho con ajustes anteriores para que puedas volver a aplicarlo.

Cuatro ajustes predefinidos rellenan estas opciones con un clic: Alfabético, package.json, Cómodo para diffs y Minificado. Cómodo para diffs usa el orden natural, ignora mayúsculas, ordena los arrays de valores simples y termina el archivo con un salto de línea, una elección sensata para un archivo que vive en un repositorio.

Orden alfabético, natural o por longitud de clave, en todos los niveles o solo en el primero, con los valores intactos. Gratis: un documento de hasta 25 MB, con todas las opciones de ordenación incluidas. Pro: sin límite de tamaño más allá de lo que aguante tu dispositivo y hasta 20 documentos a la vez en un solo archivo comprimido. Todo se ejecuta en tu dispositivo, no en nuestros servidores.

Ordenar claves JSON

¿Recursivo o solo el primer nivel?

La ordenación es recursiva por defecto: se ordena el objeto exterior, luego cada objeto que contiene, luego los que hay dentro de esos, hasta el fondo. Es lo que quieres para respuestas de API, datos exportados y la mayoría de archivos generados, porque el objetivo es una forma predecible en todas partes.

Algunos archivos tienen un orden con sentido dentro de sus secciones. Un archivo de ajustes escrito a mano puede poner host antes que port y este antes que user porque así se lee mejor, mientras que las secciones pueden ir en cualquier orden. Pon Profundidad en Solo el primer nivel y se ordenan las secciones, pero todo lo que hay dentro queda como estaba. Las opciones 2 niveles y 3 niveles quedan a medio camino.

Ajuste de profundidadQué se mueveÚtil para
Todos los nivelesLas claves de todos los objetos, a cualquier profundidadRespuestas de API, exportaciones, configuración generada
Solo el primer nivelSolo las claves exteriores (y las de cada registro de una lista en el primer nivel)Secciones ordenadas a mano, manifiestos de paquetes
2 niveles / 3 nivelesLas claves hasta esa profundidad; los objetos más profundos no se tocanConfiguraciones grandes cuyo detalle interior está ordenado a propósito

Qué pasa con los arrays

Los arrays se quedan en su orden original. A diferencia de las claves de un objeto, las posiciones de un array suelen significar algo: los pasos de una secuencia, la clasificación de unos resultados de búsqueda, las capas de una imagen. Reordenarlos cambiaría los datos, no solo su presentación. Las claves de los objetos que están dentro de un array se ordenan con las reglas normales; solo se protege la posición de los elementos.

Dos ajustes opcionales en Avanzado cambian esto cuando sí lo quieres. Ordenar también arrays de valores simples reordena los arrays que solo contienen cadenas, números, booleanos o null, como una lista de etiquetas. Los valores se agrupan primero por tipo y después se ordenan dentro de cada grupo. Ordenar listas de objetos por recibe el nombre de una propiedad, como id, y ordena una lista de registros según ella; los registros a los que les falta esa propiedad conservan su orden relativo al final. Cualquiera de los dos deja intacto un array que no encaja del todo con la regla, así que nunca obtienes una lista ordenada a medias.

Qué pasa con los números y otros valores

Muchas herramientas ordenan claves leyendo el JSON en memoria y volviendo a escribirlo. Ese viaje de ida y vuelta cambia en silencio valores que estaban bien. Este ordenador trabaja sobre el propio texto, así que los valores salen exactamente como entraron:

En tu archivoTras leer y reescribirCon este ordenador
123456789012345678901234567890123456700012345678901234567890
1.011.0
1e51000001e5
"caf\u00e9""café""caf\u00e9"
La misma clave dos vecesSolo se conserva la últimaSe conservan las dos y se cuentan

La primera fila es la que hace daño de verdad. Los números JSON corrientes se guardan como coma flotante de doble precisión, que solo representa enteros con exactitud hasta 9.007.199.254.740.991. Los identificadores largos de bases de datos, los números de pedido y las marcas de tiempo en nanosegundos suelen superar esa cifra, y al leer y reescribir el archivo sus últimas cifras se sustituyen sin aviso. Como aquí el texto no se toca, un archivo ordenado solo se diferencia del original en el orden de las claves y en los espacios.

Las claves que parecen números son otra trampa. Cuando un programa en JavaScript reconstruye un objeto, claves como "10" o "2" pasan al principio en orden numérico, pidas el orden que pidas. Aquí se ordenan como cualquier otra clave: como texto en orden Alfabético o como números en orden Natural.

Alfabético, natural o ignorar mayúsculas: qué orden elegir

El orden Alfabético compara las claves carácter por carácter según su punto de código Unicode. Eso tiene dos efectos que la gente nota. Las mayúsculas van antes que las minúsculas, así que Zone queda por encima de apple; y las letras con tilde van después del alfabeto básico, así que élan cae detrás de zebra. Activa Ignorar mayúsculas si Name y name deben quedar juntas en lugar de en dos bloques separados.

El orden Natural lee las cifras dentro de una clave como números, así que item2 va antes que item10. En orden alfabético simple item10 va primero, porque el carácter 1 es menor que el 2. Usa el orden natural para claves numeradas como step1 a step12; quédate con el alfabético cuando el archivo tenga que coincidir con lo que espera otra herramienta o un esquema, porque la mayoría ordena así.

La fijación funciona encima de cualquiera de los dos órdenes. Escribe claves en Fijar estas claves arriba, separadas por comas, y aparecerán arriba en ese orden en todos los niveles, con el resto ordenado debajo. Un asterisco final busca por prefijo, así que x-* mantiene juntos todos los campos de extensión. El ajuste predefinido package.json rellena la lista con los campos con los que ese archivo suele empezar, como name, version y description.

Cuando la ordenación sale mal

  • El archivo no se abre. El JSON no válido se indica con la línea, la columna y una marca ^ bajo el problema. Una coma que falta o una clave sin comillas suelen ser la causa; el validador JSON y el formateador JSON ayudan a corregirlo.
  • Tiene comentarios. Archivos como tsconfig.json o los ajustes de un editor llevan comentarios y comas finales, que el JSON estricto prohíbe. Activa Aceptar comentarios y comas finales; cada comentario queda unido a la clave que tiene debajo y se mueve con ella. La salida minificada no puede llevar comentarios, así que ahí se omiten.
  • Un documento por línea. Los archivos NDJSON y JSON Lines se detectan solos y cada línea se ordena por separado. El ajuste de sangría no se aplica, porque cada registro tiene que seguir en una sola línea.
  • El archivo es demasiado grande. El plan gratuito acepta un documento de hasta 25 MB. Si el archivo pesa más, minificarlo antes suele dejarlo por debajo del límite, porque la sangría puede ocupar una parte importante de un archivo bien formateado.
  • Claves que no quieres en absoluto. Ordenar solo mueve claves. Para quitar campos como identificadores internos antes de compartir un archivo, usa primero Eliminar claves JSON y después ordena.

Preguntas frecuentes

¿Cómo ordeno claves JSON alfabéticamente online?

Pega tu JSON o suelta el archivo en el ordenador de claves JSON, deja el orden en Alfabético y pulsa Ordenar claves. Cada objeto de cada nivel queda de la A a la Z, los arrays conservan su orden y puedes descargar o copiar el resultado. El plan gratuito cubre un documento de hasta 25 MB.

¿Ordenar claves JSON ordena también los objetos anidados?

Sí, por defecto. Profundidad está en Todos los niveles, así que se ordenan los objetos dentro de objetos y los objetos dentro de arrays. Elige Solo el primer nivel, 2 niveles o 3 niveles si quieres dejar los objetos más profundos como están.

¿La ordenación cambia el orden de mis arrays?

No, salvo que lo actives. El orden de un array suele tener significado, así que solo se mueven las claves de los objetos. En Avanzado puedes ordenar arrays de valores simples u ordenar una lista de objetos por una propiedad como id.

¿Ordenar claves JSON puede cambiar mis números?

Con esta herramienta, no. Los valores se copian de tu archivo carácter por carácter, así que 1.0, 1e5 y los enteros de más de 16 cifras quedan exactamente como estaban. Las herramientas que leen y reescriben el JSON pueden redondear enteros grandes y cambiar el formato de los números.

¿Por qué item10 sale antes que item2 al ordenar?

El orden alfabético compara caracteres, y el 1 va antes que el 2, así que item10 queda primero. Cambia el orden a Natural, que lee las cifras como números y pone item2 antes que item10.

¿Puedo dejar algunas claves arriba, como id o name?

Sí. Abre Avanzado y escríbelas en Fijar estas claves arriba, separadas por comas. Aparecen en ese orden por encima de las claves ordenadas, en todos los niveles. Un asterisco final, como en x-*, fija todas las claves con ese prefijo.

Sigue leyendo

Más sobre Documentos →