Comentarios en JSON
JSON estándar no permite comentarios de línea // ni comentarios de bloque /* */. Si los pegas dentro de un archivo JSON, el parser fallará.
Ejemplo incorrecto
{
// usuario activo del sistema
"usuario": "ana",
"activo": true
}Ejemplo corregido
{
"usuario": "ana",
"activo": true
}Por qué falla
Falla porque JSON solo define datos, no anotaciones. El carácter / no tiene significado válido al inicio de una propiedad.
Cómo solucionarlo
Elimina los comentarios antes de validar o minificar. Si necesitas documentar algo, usa documentación externa o una clave explícita si forma parte real del dato.
Puedes pegar el resultado en Validar JSON online para comprobarlo.
Cómo evitarlo
No mezcles archivos de configuración JSON estricto con sintaxis de JavaScript. Si una herramienta acepta comentarios, probablemente usa JSONC o JSON5, no JSON estándar.
Errores relacionados
JSON usa comillas dobles para claves y strings; las simples provocan error.
Una coma antes de cerrar un objeto o array no es válida en JSON estricto.
Un token inesperado suele indicar un carácter fuera de lugar o una estructura incompleta.
Las claves de objeto deben ir entre comillas dobles, aunque en JavaScript puedan omitirse.
Preguntas frecuentes
¿Puedo agregar una clave llamada _comment?
Técnicamente sí, pero solo si esa clave forma parte del dato y quien lo consume la acepta.
¿VS Code permite comentarios en JSON?
Algunos archivos usan JSONC. Eso no significa que el contenido sea JSON estándar válido para cualquier API.