Posso usar comentários dentro de um arquivo JSON? Se sim, como?
Não.
O JSON deve ser tudo dados, e se você incluir um comentário, então serão dados também.
Você poderia ter um elemento de dados designado chamado "_comentário"
(ou algo assim) que seria ignorado por aplicativos que utilizam os dados JSON.
Provavelmente seria melhor ter o comentário nos processos que geram/recebem o JSON, pois eles devem saber quais serão os dados do JSON com antecedência, ou pelo menos a estrutura dos mesmos.
Mas se você decidir:
{
"_comment": "comment text goes here...",
"glossary": {
"title": "example glossary",
"GlossDiv": {
"title": "S",
"GlossList": {
"GlossEntry": {
"ID": "SGML",
"SortAs": "SGML",
"GlossTerm": "Standard Generalized Markup Language",
"Acronym": "SGML",
"Abbrev": "ISO 8879:1986",
"GlossDef": {
"para": "A meta-markup language, used to create markup languages such as DocBook.",
"GlossSeeAlso": ["GML", "XML"]
},
"GlossSee": "markup"
}
}
}
}
}
A idéia por trás do JSON é fornecer uma simples troca de dados entre as aplicações. Estas são tipicamente baseadas na web e a linguagem é JavaScript.
Não permite comentários como tal, no entanto, passar um comentário como um dos pares nome/valor nos dados certamente funcionaria, embora esses dados obviamente precisariam ser ignorados ou tratados especificamente pelo código de análise.
Dito isto, não é a intenção que o arquivo do JSON contenha comentários no sentido tradicional. Devem ser apenas os dados.
Dê uma olhada no site do JSON para mais detalhes.