Como criar um arquivo JSON: sintaxe, exemplos e validação

Um arquivo JSON é texto puro estruturado em pares chave e valor que serve para trocar dados entre sistemas. Para criar do zero: abra qualquer editor de texto, escreva a estrutura seguindo 4 regras de sintaxe (aspas duplas obrigatórias, vírgulas separando cada par, tipos de dados válidos, chaves e colchetes bem fechados), salve com extensão .json e valide num serviço online.

O que trava a maioria de quem está começando é usar aspas simples em vez de duplas, esquecer uma vírgula ou fechar mal as chaves. A tabela abaixo mostra a estrutura mínima de um JSON válido com todos os tipos de dados aceitos:

O que é JSON e por que ele funciona em qualquer sistema

JSON significa JavaScript Object Notation e é um formato de dados textual que virou padrão para troca de informação entre sistemas por três razões: sintaxe leve (parecida com objeto JavaScript), leitura simples para humanos e humanos técnicos, e suporte nativo em praticamente toda linguagem de programação moderna. Um arquivo JSON pode ser aberto no Bloco de Notas, lido por Python, JavaScript, PHP, Java, ou consumido por API sem conversão.

Onde JSON aparece no dia a dia:

• package.json em projetos Node.js e JavaScript
• composer.json em projetos PHP
• Respostas de API REST (99% em JSON)
• Configurações de VS Code, ESLint, Prettier
• Exportação de dados do WhatsApp, Google Takeout, sistemas de e-commerce

Justamente por essa universalidade, saber criar um JSON limpo evita bugs em qualquer contexto onde você precisa passar dados adiante.

Como criar um arquivo JSON do zero em 5 passos

O processo básico de criar um arquivo JSON leva menos de 3 minutos e não exige nenhuma ferramenta paga. Os 5 passos abaixo funcionam igual em Windows, Mac ou Linux.

Passo 1: Abra um editor de texto. Vale Bloco de Notas do Windows, TextEdit no Mac (em modo texto simples) ou editor de código como VS Code, Sublime Text e Notepad++. Se vai criar JSON complexo, VS Code é o mais recomendado porque destaca erros de sintaxe em tempo real.

Passo 2: Digite a estrutura básica começando com chave de abertura, pares chave e valor separados por vírgula, e chave de fechamento no final:

{
  "nome": "Ana",
  "idade": 28,
  "cidade": "Porto Alegre",
  "profissao": "designer"
}

Passo 3: Respeite as 4 regras de sintaxe (detalhadas na próxima seção). Um único caractere fora do lugar torna o JSON inválido.

Passo 4: Salve o arquivo com nome descritivo seguido da extensão .json. Exemplos: dados.json, config.json, usuarios.json. No Bloco de Notas do Windows, no diálogo de salvar escolha “Tipo: Todos os arquivos” e digite o nome com .json no final, senão vira arquivo.json.txt.

Passo 5: Valide no JSONLint: cole o conteúdo na caixa da esquerda, clique em Validate JSON. Se retornar “Valid JSON”, está pronto para uso. Se retornar erro, ele indica a linha exata do problema.

Para salvar o arquivo corretamente com codificação UTF-8 e sem BOM (que quebra parsers), o passo a passo detalhado por editor está em como salvar arquivo JSON.

Sintaxe JSON: as 4 regras que não podem ser quebradas

JSON é rígido em 4 regras de sintaxe que, quebradas, tornam o arquivo inválido e inutilizável em qualquer sistema. Conhecer as 4 evita 90% dos erros que aparecem na primeira validação.

Regra 1: aspas duplas obrigatórias

Chaves e strings precisam de aspas duplas. Aspas simples são inválidas em JSON. Esse é o erro número um de quem vem de JavaScript, onde aspas simples funcionam.

{
  "nome": "Ana"
}

Errado:

{
  'nome': 'Ana'
}

Regra 2: vírgula separando cada par, sem vírgula sobrando no final

Cada par chave e valor precisa de vírgula depois, exceto o último. Vírgula depois do último par (chamada de trailing comma) é permitida em JavaScript mas quebra JSON.

Correto:

{
  "nome": "Ana",
  "idade": 28
}

Errado (vírgula sobrando):

{
  "nome": "Ana",
  "idade": 28,
}

Regra 3: só 6 tipos de dados aceitos

Os únicos tipos válidos em JSON são: string (entre aspas duplas), número (inteiro ou decimal, sem aspas), booleano (true ou false, sem aspas), null (sem aspas), array (entre colchetes) e objeto (entre chaves). Datas, funções e variáveis não são tipos JSON válidos.

Regra 4: chaves e colchetes bem fechados

Cada { precisa de } correspondente. Cada [ precisa de ]. Editor com destaque de sintaxe (VS Code, Sublime, Notepad++) ajuda a visualizar o par correspondente. Um { a mais quebra tudo.

Tipos de dados aceitos no JSON

Os 6 tipos de dados aceitos em JSON cobrem 100% do que qualquer troca de informação precisa. Se um dado não se encaixa em um deles, JSON não é o formato ideal para transportá-lo. A tabela abaixo detalha cada tipo com exemplo prático:

Datas precisam virar string no formato ISO 8601 ("2026-07-09"). Valores monetários geralmente ficam como números decimais. Arquivos binários (imagens, PDFs) NÃO cabem em JSON, precisa converter para base64 primeiro ou passar como URL.

5 exemplos práticos de arquivo JSON completo

Cinco exemplos completos que cobrem os cenários mais comuns onde você vai precisar criar JSON na prática.

Exemplo 1: configuração simples

{
  "nome_projeto": "meu-site",
  "versao": "1.0.0",
  "autor": "Sara Lima",
  "producao": false
}

Exemplo 2: lista de produtos (array de objetos)

{
  "produtos": [
    {
      "id": 1,
      "nome": "Notebook",
      "preco": 3499.00,
      "estoque": 12
    },
    {
      "id": 2,
      "nome": "Mouse sem fio",
      "preco": 89.90,
      "estoque": 45
    }
  ]
}

Exemplo 3: usuário com dados aninhados

{
  "usuario": {
    "id": 1001,
    "nome": "Ana Silva",
    "email": "[email protected]",
    "endereco": {
      "cidade": "Curitiba",
      "estado": "PR",
      "cep": "80000-000"
    },
    "tags": ["cliente-vip", "assinante"]
  }
}

Exemplo 4: package.json simplificado (projeto Node.js)

{
  "name": "meu-projeto",
  "version": "1.0.0",
  "description": "Site institucional em Next.js",
  "main": "index.js",
  "scripts": {
    "dev": "next dev",
    "build": "next build",
    "start": "next start"
  },
  "dependencies": {
    "next": "14.0.0",
    "react": "18.2.0"
  }
}

Exemplo 5: resposta de API REST

{
  "status": "success",
  "code": 200,
  "data": {
    "id": 42,
    "titulo": "Novo post",
    "autor": "Sara Lima",
    "publicado_em": "2026-07-09T14:30:00Z",
    "tags": ["seo", "wordpress"]
  }
}

Esses cinco padrões cobrem praticamente todo o JSON que você vai criar em contextos reais. Alterar campo, adicionar chave ou remover valor mantendo a estrutura funciona igual.

Como criar arquivo JSON programaticamente

Além de criar manualmente no editor, JSON é gerado por código em qualquer linguagem moderna. Três exemplos práticos das linguagens mais usadas em 2026.

Python (biblioteca json nativa):

import json

dados = {
    "nome": "Ana",
    "idade": 28,
    "cidade": "Porto Alegre"
}

with open("dados.json", "w", encoding="utf-8") as arquivo:
    json.dump(dados, arquivo, ensure_ascii=False, indent=2)

O ensure_ascii=False preserva acentos e o indent=2 deixa formatado. Sem esses parâmetros, saída fica em uma linha só e acentos viram códigos escape.

JavaScript (Node.js):

const fs = require('fs');

const dados = {
  nome: "Ana",
  idade: 28,
  cidade: "Porto Alegre"
};

fs.writeFileSync('dados.json', JSON.stringify(dados, null, 2));

O JSON.stringify(dados, null, 2) converte objeto em string formatada com indentação de 2 espaços.

PHP:

<?php
$dados = [
    "nome" => "Ana",
    "idade" => 28,
    "cidade" => "Porto Alegre"
];

file_put_contents(
    'dados.json',
    json_encode($dados, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE)
);
?>

O JSON_PRETTY_PRINT formata com indentação. O JSON_UNESCAPED_UNICODE preserva acentos.

Para entender a diferença entre criar arquivo e apenas ler JSON já existente (parsing com código), o artigo como ler arquivo JSON cobre o caminho inverso com exemplos nas mesmas linguagens.

Como criar JSON usando IA em 2026

Modelos de IA como ChatGPT, Claude e Gemini geram JSON válido diretamente a partir de instruções em linguagem natural. Isso virou o caminho mais rápido para criar estruturas complexas sem escrever chave por chave.

Como prompt eficaz para gerar JSON:

1. Peça o formato explicitamente: “Gere um JSON com…”
2. Descreva a estrutura desejada em português comum
3. Peça exemplos preenchidos com dados fictícios se for estrutura de teste

Exemplo de prompt bom:

Gere um JSON com estrutura de catálogo de produtos. Cada produto deve ter id, nome, preço em decimal, estoque (número inteiro), array de tags, e objeto de dimensões (altura, largura, profundidade em cm). Preencha com 3 produtos fictícios.

Cuidados ao usar IA para JSON:

• Sempre valide no JSONLint. IA erra sintaxe ocasionalmente (vírgula sobrando, aspas erradas)
• Verifique tipos: peça explicitamente se um valor deve ser número ou string
• Copie o resultado limpo sem os textos explicativos que a IA costuma adicionar antes e depois

Para gerar JSON dentro do próprio VS Code, a extensão Copilot também sugere estruturas completas conforme você digita. Útil quando você já tem o esqueleto e quer preencher variações rápidas.

Ferramentas para criar e validar JSON online

Três ferramentas online resolvem os cenários mais comuns de criar, formatar e validar JSON sem instalar nada. A tabela abaixo compara:

JSONLint é o padrão de validação: cole o JSON, clique em Validate JSON. Se der erro, mostra a linha exata. Se der certo, retorna “Valid JSON” formatado.

JSON Editor Online tem editor lado a lado texto/árvore. Você monta a estrutura clicando e ele gera o JSON. Bom para quem prefere visual em vez de digitar.

JSON Formatter foca em duas coisas: pegar JSON minificado (uma linha só) e formatar bonito com indentação, ou pegar JSON bonito e minificar para economizar bytes ao enviar por API.

Todas as três rodam 100% no navegador sem enviar seus dados para servidor. Mas se o JSON tem informação sensível (senhas, tokens de API), prefira sempre editor offline como VS Code ou o Visual Studio Code instalado localmente.

5 erros comuns ao criar arquivo JSON e como corrigir

Erro 1: usar aspas simples. Sintoma: JSONLint retorna “Parse error on line X”. Causa: JSON exige aspas duplas obrigatoriamente. Correção: substitua todas as aspas simples por duplas. Se o arquivo é grande, use Find & Replace do editor.

Erro 2: vírgula sobrando no fim. Sintoma: Unexpected token }. Causa: você deixou vírgula depois do último par antes de fechar } ou ]. Correção: remova a vírgula final.

Erro 3: chaves não fechadas. Sintoma: Unexpected end of JSON input. Causa: falta um } ou ] para fechar objeto ou array. Correção: use editor com destaque de sintaxe (VS Code) que colore o par correspondente para visualizar.

Erro 4: nome de chave sem aspas. Sintoma: Parse error. Causa: escreveu nome: "Ana" em vez de "nome": "Ana". Correção: todas as chaves (nomes dos campos) precisam de aspas duplas.

Erro 5: caractere BOM invisível no início. Sintoma: JSON parece correto mas parser retorna erro estranho. Causa: arquivo salvo com BOM (Byte Order Mark) que aparece antes do primeiro {. Correção: no Notepad++, vá em Codificação > Codificar em UTF-8 (sem BOM) e salve.

Um sexto erro que aparece sozinho: acentos virando símbolos estranhos. Isso acontece quando você salva o arquivo em codificação errada (ISO-8859-1 em vez de UTF-8). Sempre salve como UTF-8. Em VS Code, o indicador de codificação fica no canto inferior direito.

Se o problema é abrir o arquivo pronto em outro contexto (por exemplo, importar num sistema), o passo a passo para abrir arquivo JSON no Windows, Mac, celular e online cobre a leitura em cada ambiente.

O vídeo do canal Adriano Viana explica sobre JSON do zero com estrutura, sintaxe e casos práticos:

Perguntas frequentes

Como criar um arquivo JSON no Bloco de Notas do Windows?

Abra o Bloco de Notas, digite a estrutura JSON completa com chaves, pares chave-valor e todos os fechamentos. Vá em Arquivo > Salvar como, no diálogo escolha “Tipo: Todos os arquivos” e digite o nome com .json no final (por exemplo, dados.json). Escolha “Codificação: UTF-8” no canto inferior. Valide depois no JSONLint para confirmar que a sintaxe está correta.

Qual a extensão certa para um arquivo JSON?

A extensão padrão é .json (minúsculo). Qualquer variação como .JSON, .json.txt ou sem extensão pode causar problemas em sistemas que esperam a extensão exata. No Windows, cuidado com a opção “Ocultar extensões de arquivos conhecidos” que pode mascarar erros como arquivo.json.txt aparecendo como arquivo.json.

É possível criar JSON válido sem programar?

Sim. Editor de texto qualquer (Bloco de Notas, TextEdit) resolve. A única exigência é seguir as 4 regras de sintaxe: aspas duplas, vírgulas separando pares (sem trailing), tipos válidos e chaves/colchetes bem fechados. Depois de escrever, validar no JSONLint confirma se está tudo certo antes de usar.

Preciso aprender JavaScript para criar JSON?

Não. JSON tem sintaxe inspirada em JavaScript mas é um formato universal usado por Python, PHP, Java, Ruby, C#, Go e praticamente qualquer linguagem. Você pode criar JSON sem escrever uma linha de código, só com editor de texto. Programar ajuda quando você precisa gerar JSON dinamicamente a partir de dados (banco de dados, formulário), mas não é necessário para o arquivo em si.

Como criar JSON com múltiplos registros (array de objetos)?

Coloque os objetos individuais entre colchetes [ ] separados por vírgulas. Por exemplo, três usuários: [{"nome": "Ana"}, {"nome": "Beto"}, {"nome": "Carla"}]. Se quiser envolver o array numa chave nomeada, coloque tudo dentro de um objeto pai: {"usuarios": [{...}, {...}]}.

Qual a diferença entre criar arquivo JSON e string JSON?

Arquivo JSON é o conteúdo salvo em disco com extensão .json. String JSON é o mesmo conteúdo como texto na memória do programa (por exemplo, resposta de API vem como string JSON antes de ser convertida em objeto). Ambos seguem exatamente a mesma sintaxe. Um vira o outro com JSON.stringify() no JavaScript ou json.dumps() no Python.

Posso incluir comentários em arquivo JSON?

Não. JSON puro não aceita comentários (// ou /* */). É uma das principais críticas ao formato. Se precisa de comentários, adicione um campo especial no próprio JSON como "_comentario": "explicação aqui" ou use uma variação como JSON5 que aceita comentários (mas não é reconhecido por todos os parsers).

Existe limite de tamanho para um arquivo JSON?

Não existe limite técnico no formato JSON, mas ferramentas têm limites práticos. Editores gráficos como VS Code lidam bem com arquivos até 50 MB. Acima disso ficam lentos. Parsers em programação também podem estourar memória se carregarem o arquivo inteiro. Para JSONs muito grandes (100 MB+), streaming com jq no terminal ou bibliotecas específicas como ijson em Python resolvem sem carregar tudo em memória.