Ordenar claves JSON alfabéticamente: qué cambia y qué no

Contenido
Ordenar las claves de un JSON solo cambia el orden de las propiedades de un objeto (object) a orden alfabético (o inverso); no toca el orden de los elementos de un array ni los valores de los datos. Es la función que necesita quien quiera comparar lado a lado dos JSON guardados en momentos distintos o dos respuestas de una API, y también quien tenga que dejar presentable un archivo de configuración desordenado. Solo si sabes con exactitud hasta dónde llega cada opción obtendrás el resultado que buscas.
Resumen ① Ordenar cambia únicamente el orden de las claves de los objetos; el orden de los elementos de los arrays y todos los valores se mantienen igual. ② Hay que activar «Ordenar de forma recursiva» para que se ordenen también las claves de los objetos anidados y de los objetos dentro de arrays; si está desactivada, solo se ordenan las claves del nivel más externo. ③ Si la sintaxis del JSON es incorrecta, en lugar del resultado ordenado se muestra tal cual el mensaje de error que lanza el navegador.
Por qué ocurre este problema
Es habitual que el orden de las claves de una respuesta de API o de un archivo de configuración cambie según cómo se generen. Dependiendo del orden en que el código añade propiedades al objeto o del orden en que la librería exporta los valores, la disposición de las claves puede variar cada vez, aunque el JSON contenga la misma información.
En esa situación, si comparas con un diff o a simple vista el JSON que guardaste ayer con el que has recibido hoy, los valores son idénticos pero las líneas aparecen en posiciones distintas, así que cuesta encontrar la diferencia real. Si fijas las claves con la misma regla (orden alfabético), ese ruido desaparece y solo saltan a la vista los valores que de verdad han cambiado.
Eso sí, ordenar no es «organizar el contenido». Ordenar cambia únicamente el orden en que se enumeran las claves. Si tienes claro este límite, no malinterpretarás el resultado.
Cómo ordenar a mano sin herramientas
Puedes ordenar las claves de un JSON desde la terminal o con unas pocas líneas de código, sin navegador ni herramientas adicionales. Hay dos métodos habituales.
- Usar jq: la herramienta de línea de comandos para procesar JSON jq tiene la opción
-S(de sort, ordenar). Si ejecutasjq -S '.' data.json, obtienes como salida las claves de los objetos de todos los niveles ordenadas alfabéticamente. - Usar Python: si ejecutas
python3 -c "import json;print(json.dumps(json.load(open('data.json')),sort_keys=True,indent=2))", obtienes igualmente el resultado con las claves de todos los niveles ordenadas.
Ninguno de los dos métodos permite elegir entre «ordenar solo el nivel superior» y «ordenar todo de forma recursiva»: si lo activas, siempre se ordenan todos los niveles. En cambio, ninguno de los dos toca el orden del propio array. Tanto jq como Python tratan los arrays como listas ordenadas y no los consideran objeto de reordenación.
Cómo comprobar antes los errores de sintaxis
Para comprobar antes si la sintaxis es correcta, basta con ejecutar python3 -m json.tool data.json. Si el JSON es incorrecto, aparece un error que indica en qué línea y columna se produce el problema; si es correcto, se imprime directamente el resultado formateado.
En lugar de escribir el comando cada vez, puedes comprobar lo mismo pegando el texto en el navegador. Compruébalo con nuestra herramienta.
Ordena y formatea al instante el JSON que introduces en el navegador, y los datos no se envían a ningún servidor.

Antes y después de ordenar: comparación con un ejemplo real
Vamos a comparar el antes y el después de ordenar con el siguiente JSON.
{
"name": "무선 이어폰",
"price": 89000,
"stock": { "seoul": 12, "busan": 5, "daegu": 20 },
"reviews": [
{ "rating": 5, "comment": "좋아요" },
{ "rating": 3, "comment": "보통이에요" }
]
}
Con la opción recursiva desactivada: solo se ordenan las claves externas
Si activas solo «Ordenar claves alfabéticamente» y dejas la opción recursiva desactivada, el resultado es este.
{
"name": "무선 이어폰",
"price": 89000,
"reviews": [
{ "rating": 5, "comment": "좋아요" },
{ "rating": 3, "comment": "보통이에요" }
],
"stock": { "seoul": 12, "busan": 5, "daegu": 20 }
}
Solo se han reordenado alfabéticamente las claves del nivel más externo (name, price, reviews, stock). El orden de las dos reseñas dentro del array reviews sigue igual, y también el de rating y comment dentro de cada objeto de reseña, así como el de seoul, busan y daegu dentro de stock.
Con la opción recursiva activada: también se ordenan los objetos internos y los objetos dentro de arrays
Si en la misma situación activas además «Ordenar de forma recursiva», el resultado cambia.
{
"name": "무선 이어폰",
"price": 89000,
"reviews": [
{ "comment": "좋아요", "rating": 5 },
{ "comment": "보통이에요", "rating": 3 }
],
"stock": { "busan": 5, "daegu": 20, "seoul": 12 }
}
Las claves del objeto stock se han ordenado como busan, daegu, seoul, y las claves de cada objeto de reseña dentro del array reviews también se han ordenado como comment, rating. Sin embargo, el «orden» de las dos reseñas del propio array reviews sigue siendo el mismo. La reseña con valoración 5 sigue estando en primer lugar. La opción recursiva actúa solo sobre el orden de las claves de los objetos y no interviene en el orden de los elementos que contiene un array.
La indentación solo mejora la presentación
La elección de indentación (2 espacios, 4 espacios o tabulación) no afecta al resultado de la ordenación ni a los valores: solo cambia el ancho del espacio en blanco entre saltos de línea. Si generas el mismo resultado ordenado con 2 y con 4 espacios, queda así.
{
"a": 1,
"b": 2
}
{
"a": 1,
"b": 2
}
Si eliges tabulación, se indenta con el carácter de tabulación en lugar de espacios. El ancho con que se ve una tabulación en pantalla puede variar según la configuración de ancho de tabulación del editor de código.
El error que aparece cuando la sintaxis es incorrecta
Si hay un solo error de sintaxis en el JSON, no se genera ningún resultado ordenado y solo se muestra un mensaje de error indicando que el análisis ha fallado. Por ejemplo, si introduces {"a":1, al que le falta la llave de cierre, el navegador lanza un error como «Unexpected end of JSON input», que indica que la entrada se ha cortado a mitad.
También falla el análisis si sobra una coma, como en {"a":1,"b":2,}, donde queda una coma detrás del último elemento, o si escribes una clave sin comillas, como en {a:1}. En ese caso aparece un error con información de posición que indica en qué carácter se produce el problema, aunque el texto exacto y la forma de indicar la posición varían ligeramente según el navegador (el motor de JavaScript) y la versión.
Hay algo en común: la herramienta no genera por su cuenta el texto del error, sino que muestra tal cual el error que lanza realmente el motor de JavaScript. Basta con mirar la posición indicada en el mensaje de error y revisar en ese punto las comas, las comillas y los paréntesis.
Equivocaciones y errores frecuentes
Estas son las equivocaciones más habituales la primera vez que se usa la función de ordenar.
| Equivocación | Comportamiento real |
|---|---|
| Al ordenar también cambia el orden de los arrays | El orden de los elementos de un array siempre se mantiene igual, independientemente de la opción de ordenación |
| Basta con marcar la casilla de ordenar para que se ordenen también los objetos anidados | Hay que activar aparte «Ordenar de forma recursiva» para que se ordenen también los objetos internos |
| Ordenar también reubica los valores (value) | Lo único que cambia es el orden en que se enumeran las claves; los valores quedan como en el original |
| Aunque la sintaxis tenga algún error, lo arregla solo | Si la sintaxis es incorrecta, el propio análisis falla y no se genera ningún resultado |
| Ordenar en orden inverso es volver al orden original (de entrada) | El orden inverso es el alfabético de Z a A, no el orden original en que se introdujo |
En resumen
- Ordenar cambia solo el orden de las claves de los objetos, en orden alfabético (o inverso); el orden de los elementos de los arrays y todos los valores se mantienen igual.
- Con «Ordenar de forma recursiva» desactivada se ordenan solo las claves del nivel más externo; con ella activada, también las claves de los objetos anidados y de los objetos dentro de arrays.
- La indentación (2 espacios, 4 espacios o tabulación) es solo un formateo para que se vea mejor y no influye en el resultado de la ordenación ni en los valores.
- Si la sintaxis del JSON es incorrecta, en lugar del resultado se muestra tal cual el mensaje de error que lanza realmente el motor de JavaScript.
- También puedes hacer la misma tarea a mano con jq -S o con sort_keys=True de Python, pero estos ordenan siempre todo de forma recursiva y no permiten elegir «ordenar solo el nivel superior».
Ordena y formatea al instante el JSON que introduces en el navegador, y los datos no se envían a ningún servidor.
Preguntas frecuentes
¿Ordenar las claves también cambia los valores de los datos originales?
No. Lo único que cambia es el orden en que se enumeran las claves dentro de un objeto; los valores en sí —cadenas, números, booleanos— no se modifican en absoluto. La especificación de JSON (RFC 8259) tampoco define el orden de los miembros de un objeto como información significativa, así que ordenar es solo reorganizar el orden para que sea más fácil de leer para las personas y no altera el significado de los datos.
¿Las claves numéricas también se ordenan como 1, 2, 10?
No. La ordenación compara las claves como cadenas, de modo que las claves que parecen números, como "10" y "2", también se comparan carácter por carácter. Como el primer carácter '1' va antes que '2', el resultado es una ordenación lexicográfica (por cadenas) en la que "10" aparece antes que "2".
¿Cómo cambio el orden de los objetos dentro de un array?
Con esta función no es posible. La opción de ordenación solo cambia el orden de las "claves" de un objeto y no interviene en el orden de los "elementos" que contiene un array, ni siquiera activando la opción recursiva. Para cambiar el orden de los elementos en sí hace falta una operación de ordenación aparte.
¿El JSON que introduzco se envía a un servidor?
No. El análisis (parseo), la ordenación y el formateo se realizan únicamente dentro del navegador y no se envían a ningún servidor.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano