Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Diagnósticos, códigos de erro e CLI

Quando algo dá errado, o CGD mostra exatamente onde está o problema, dá um código estável (como E3109) e muitas vezes já sugere o nome certo. Você ainda pode pedir explicação detalhada direto no terminal.

Consultando um código de erro

Viu um erro como E3109 ou E3403 e não entendeu de primeira? Rode cgd --explicar CODIGO no terminal para ler o motivo e como corrigir. Para scripts e editores, --diagnosticos=json devolve tudo estruturado em JSON Lines.

cgd programa.delegua --verificar
cgd --explicar E3109
cgd programa.delegua --verificar --diagnosticos=json

Experimente: 05_diagnosticos

// Dois erros independentes: o parser recupera e reporta os dois.
var primeiro: qualquer =;
var segundo: qualquer =;

Ver exemplo completo e contrato de teste no GitHub

Experimente: 06_sugestao

var mensagem: texto = "Olá"
escreva(mensage)

Ver exemplo completo e contrato de teste no GitHub

Experimente: 12_divisao_estatica

const zero: inteiro = 3 - 3
escreva(10 / zero)

Ver exemplo completo e contrato de teste no GitHub

Experimente: 13_indice_unicode

// 'ação' tem quatro pontos de código; o maior índice positivo é 3.
escreva("ação"[4])

Ver exemplo completo e contrato de teste no GitHub

Experimente: 14_falha_tratada

// Uma operação deliberadamente inválida dentro de pegue recebe aviso W3101.
// A exceção continua tratável, e a localização não exige chamada por linha.
tente {
    escreva(1 / 0)
} pegue (erro) {
    escreva("tratado")
}

Ver exemplo completo e contrato de teste no GitHub

Códigos de diagnóstico

CódigoMensagemO que fazer
R0001%sFalha dinâmica do runtime; consulte a operação e a localização informadas. Tipos dinâmicos, aliases e entrada externa continuam validados em execução.
E0001%sDiagnóstico legado; consulte a mensagem e a posição.
W0001%sAviso legado; consulte a mensagem e a posição.
H0001%sInformação complementar de um diagnóstico.
E0002Limite de diagnósticos atingido; corrija os erros anteriores.O limite protege contra uma cascata de erros.
E9001%sVerifique arquivos, opções, dependências e a toolchain configurada.
E2001Ciclo de importação detectado: %sQuebre a dependência circular mostrada pela cadeia de importação.
E2002Limite de recursos de carregamento de módulos excedido.Divida o grafo; os limites de tamanho e quantidade são documentados.
E2003%s
Importado por: %sConfira o caminho literal relativo ao módulo que importa.
W4002Carregamento dinâmico/NPM/FFI não é suportado por segurança.Use fontes .delegua conhecidas na compilação.
E4002Importe um módulo fonte .delegua.Importação de código nativo ou carregado dinamicamente é excluída.
E1000Fim inesperado do arquivo; verifique delimitadores e expressões incompletas.Feche os delimitadores e complete a última expressão.
E1001%sA mensagem descreve o token ou expressão esperado; o parser tenta recuperar em outro comando.
E3002Incompatibilidade de tipo: era esperado '%s' mas foi recebido '%s'.Use um tipo compatível com o contrato declarado.
W4001Captura externa de '%s' detectada: exigiria upvalues, recurso desabilitado por segurança.Passe estado por parâmetros ou receptor explícito.
E4001A captura foi bloqueada; passe o valor como parâmetro explícito.Capturas de ambiente são excluídas deliberadamente do perfil compilado.
E1002Arquivo fonte não contém UTF-8 válido.Salve a fonte como UTF-8.
E1003Limite de aninhamento sintático excedido.Divida expressões ou blocos profundamente aninhados.
E1005Literal numérico inválido ou fora do intervalo.Literais inteiros exigem 64 bits; literais reais precisam ser finitos e representáveis em 64 bits.
E1004Limite estrutural da AST excedido; divida a expressão ou o módulo.O frontend limita profundidade e quantidade de nós antes dos passes recursivos.
E3001O símbolo '%s' não foi declarado.Verifique escopo e grafia; funções não capturam ambientes externos.
E3011Campos estáticos ainda não são suportados; declare um método estático.Esta versão oferece campos de instância e métodos estáticos; a ausência de campos estáticos não é uma exclusão de segurança.
E3012Construtor não pode ser estático.O construtor inicializa uma instância gerenciada e recebe isto; use outro nome para uma fábrica estática.
H3001Você quis dizer '%s'?Sugestão determinística de nome visível no escopo.
W3001Código inalcançável após transferência de controle.Remova ou reorganize a cauda que não executa.
W3002Função com retorno tipado pode terminar sem retornar valor; o retorno implícito é nulo.Garanta um retorno nos caminhos relevantes.
E3101Divisão ou módulo por zero demonstrável em compilação.O denominador é uma expressão constante igual a zero.
E3102Resultado inteiro fora do intervalo de 64 bits.Altere o cálculo ou use valores reais quando apropriado.
E3103Índice constante inválido: %s.Índices negativos são aceitos dentro dos limites da coleção.
E3104Incompatibilidade de tipo demonstrável: esperado '%s', recebido '%s'.Contratos explícitos não são removidos pela otimização.
E3105Operação demonstravelmente inválida: %s.Use os tipos e limites aceitos pelo runtime.
E3106Conversão literal inválida para '%s'.Valide o texto de entrada ou trate dados recebidos em execução.
E3107Deslocamento constante fora do intervalo [0, 63].A quantidade de bits precisa estar dentro dos limites de 64 bits.
E3108O passo constante de uma fatia não pode ser zero.Use um passo positivo ou negativo diferente de zero.
E3109Membro '%s' não existe em '%s'.Verifique o nome do método, campo ou exportação disponível para este tipo.
E3110Não é possível modificar elemento de '%s' imutável.Textos e tuplas são imutáveis; crie um novo valor ou utilize um vetor.
E3111Operação '%s' inválida sobre valor comprovadamente nulo.Verifique se o valor não é nulo antes de acessar membros, indexar ou chamar.
E3112O valor do tipo '%s' não pode ser chamado como função.Apenas funções, métodos e classes construtíveis podem ser invocados.
E3014Membro '%s' não é acessível neste contexto.Respeite a visibilidade público, protegido ou privado da declaração que oculta as herdadas.
E3015Membro '%s' exige uma instância.Instancie a classe antes de acessar campos e métodos de instância.
E3016A função '%s' espera entre %s e %s argumentos; recebeu %s.Respeite argumentos obrigatórios, opcionais e variáveis da função ou método.
E3017%sO destino precisa ser modificável; funções, constantes e o receptor isto não podem ser reatribuídos.
E3201Função pura depende do estado externo '%s'.Passe o valor por parâmetro; a CTFE não lê nem modifica variáveis externas à função.
E3013Destrutor deve ser público, de instância, sem parâmetros e retornar vazio.Declare destrutor(): vazio e use destruir(objeto) em finalmente para liberar recursos explicitamente.
E3301Construção assíncrona fora de um contexto permitido.Aguardar exige corpo assincrono. Defaults, inicializadores, acessores, ciclo de vida e assinaturas FFI são síncronos.
E3302Aguardar exige Promessa ou Tarefa; recebeu '%s'.Uma operação síncrona não se torna assíncrona por aguardar. Use uma função assincrona ou rotina.
E3303Função assíncrona não aceita avaliação pura/CTFE.O loop e as continuações só executam no programa nativo, nunca no compilador ou editor.
E3304Método não preserva o efeito assíncrono do contrato.Implementação e override devem manter assincrona e o tipo de resultado declarado.
E3305Construção ainda não suportada no lowering assíncrono: %s.A implementação incremental rejeita esta construção explicitamente; não há fallback bloqueante.
E3306Resultado vazio de aguardar não pode ser usado como valor.Use aguardar como comando quando a Promise é Promessa.
E3307Limite de recursos da IR assíncrona excedido.Divida a função: até 100000 instruções/slots, 2000000 fatos de vivacidade e 50000000 visitas de instrução/fato por análise.
E3401Rotina exige chamada direta a função de topo ou método estático conhecido, sem captura.Chame diretamente uma função declarada no módulo ou método estático de classe gerenciada.
E3402Função '%s' não é segura para execução paralela em rotina: %s.Rotinas não podem acessar globais mutáveis, FFI, I/O síncrono ou chamadas indiretas sem contrato.
E3403Rotina aceita apenas argumentos e retorno transferíveis (nulo, lógico, inteiro, real ou texto); recebeu '%s'.Transfira apenas valores escalares ou textos copiados; coleções e objetos mutáveis não atravessam threads.
E3404Função assíncrona não pode ser iniciada diretamente com rotina; use chamada normal e aguardar.Corrotinas assíncronas executam no loop cooperativo da thread principal, não no pool paralelo.

Os códigos E3101–E3112 cobrem segurança estática (e W3101–W3112 quando estão dentro de tente/pegue). O LSP no VS Code usa exatamente os mesmos diagnósticos e oferece correção rápida (quick-fix) para sugestões H3001.