Índice de Contenido

Introducción a los archivos JSON

Los archivos JSON (JavaScript Object Notation) son uno de los formatos más populares para el almacenamiento y transferencia de datos entre aplicaciones. Su estructura ligera y legible lo convierten en una excelente opción para guardar información de manera sencilla y eficiente.

En esta guía fácil y rápida aprenderás cómo guardar y cargar datos en un archivo JSON paso a paso, utilizando ejemplos prácticos y explicaciones claras. Además, descubrirás diferentes formas de manipular archivos JSON en Python, uno de los lenguajes más utilizados para este propósito.

¿Qué es un archivo JSON?

Un archivo JSON es un archivo de texto que almacena datos estructurados en formato de clave-valor. Su sintaxis es muy similar a la de los objetos en JavaScript, pero puede ser usado en diversos lenguajes de programación.

Por ejemplo, un archivo datos.json podría verse así:

{
    "nombre": "Juan",
    "edad": 30,
    "ciudad": "Madrid"
}

Ventajas de guardar datos en archivos JSON

Fácil de leer y escribir tanto para humanos como para máquinas.
Ligero y eficiente para almacenar información.
Compatible con la mayoría de lenguajes de programación.
Ideal para la transferencia de datos entre aplicaciones y servicios web.

¿Cómo guardar datos en un archivo JSON paso a paso?

Para guardar información en un archivo JSON desde Python, utilizamos el módulo json que viene incluido en la biblioteca estándar. A continuación, te mostramos cómo hacerlo en unos simples pasos:

Paso 1: Preparar los datos

Los datos deben estar en una estructura que pueda convertirse a JSON, como un diccionario o una lista de Python.

# Ejemplo de datos
datos = {
    "nombre": "Ana",
    "edad": 25,
    "ciudad": "Barcelona"
}

Paso 2: Abrir o crear el archivo JSON

Usamos la función open() en modo w (escritura).

# Abrir archivo en modo escritura
with open(datos.json, w) as archivo:
    pass

Paso 3: Guardar los datos en el archivo JSON

Utilizamos json.dump() para escribir los datos en el archivo.

import json

datos = {
    "nombre": "Ana",
    "edad": 25,
    "ciudad": "Barcelona"
}

with open(datos.json, w) as archivo:
    json.dump(datos, archivo, indent=4)  # indent=4 para que sea legible

¡Listo! Así de sencillo es guardar datos en un archivo JSON usando Python.

¿Cómo cargar datos de un archivo JSON paso a paso?

Para leer información almacenada en un archivo JSON, seguimos estos pasos:

Paso 1: Abrir el archivo JSON

Abrimos el archivo en modo r (lectura).

# Abrir archivo en modo lectura
with open(datos.json, r) as archivo:
    pass

Paso 2: Leer los datos del archivo JSON

Usamos json.load() para cargar los datos en una variable de Python.

import json

with open(datos.json, r) as archivo:
    datos = json.load(archivo)

print(datos)
# Salida: {nombre: Ana, edad: 25, ciudad: Barcelona}

Así de fácil es cargar datos desde un archivo JSON en tu programa.

¿Cómo almacenar y recuperar listas de datos en un archivo JSON?

JSON permite guardar no solo objetos (diccionarios), sino también listas de elementos. Por ejemplo, puedes guardar una lista de usuarios:

usuarios = [
    {"nombre": "Ana", "edad": 25},
    {"nombre": "Luis", "edad": 32},
    {"nombre": "Marta", "edad": 28}
]

Para guardar esta lista en un archivo JSON:

import json

with open(usuarios.json, w) as archivo:
    json.dump(usuarios, archivo, indent=4)

Y para leer la lista de usuarios:

import json

with open(usuarios.json, r) as archivo:
    usuarios = json.load(archivo)

print(usuarios)

Consejos y buenas prácticas al trabajar con archivos JSON

Utiliza indentación (indent=4) para que el archivo sea más legible.
Siempre maneja excepciones usando try...except para evitar errores al leer o escribir archivos.
Verifica que los datos que vas a guardar sean serializables (no puedes guardar objetos personalizados sin transformarlos).
No olvides cerrar los archivos (el uso de with open(...) lo hace automáticamente).

Ejemplo de manejo de errores al cargar un JSON

import json

try:
    with open(datos.json, r) as archivo:
        datos = json.load(archivo)
except FileNotFoundError:
    print("El archivo no existe.")
except json.JSONDecodeError:
    print("El archivo no contiene un JSON válido.")

Conclusión: Guardar y cargar datos en archivos JSON es sencillo y útil

Ahora ya sabes cómo guardar y cargar datos en un archivo JSON paso a paso. Usar JSON para almacenar información es una técnica poderosa, sencilla y ampliamente utilizada en el desarrollo de software moderno.

Practica estos ejemplos y adapta el proceso a tus propios proyectos para aprovechar todas las ventajas que te ofrece el formato JSON.