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ódigo | Mensagem | O que fazer |
|---|---|---|
| R0001 | %s | Falha 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 | %s | Diagnóstico legado; consulte a mensagem e a posição. |
| W0001 | %s | Aviso legado; consulte a mensagem e a posição. |
| H0001 | %s | Informação complementar de um diagnóstico. |
| E0002 | Limite de diagnósticos atingido; corrija os erros anteriores. | O limite protege contra uma cascata de erros. |
| E9001 | %s | Verifique arquivos, opções, dependências e a toolchain configurada. |
| E2001 | Ciclo de importação detectado: %s | Quebre a dependência circular mostrada pela cadeia de importação. |
| E2002 | Limite de recursos de carregamento de módulos excedido. | Divida o grafo; os limites de tamanho e quantidade são documentados. |
| E2003 | %s | |
| Importado por: %s | Confira o caminho literal relativo ao módulo que importa. | |
| W4002 | Carregamento dinâmico/NPM/FFI não é suportado por segurança. | Use fontes .delegua conhecidas na compilação. |
| E4002 | Importe um módulo fonte .delegua. | Importação de código nativo ou carregado dinamicamente é excluída. |
| E1000 | Fim inesperado do arquivo; verifique delimitadores e expressões incompletas. | Feche os delimitadores e complete a última expressão. |
| E1001 | %s | A mensagem descreve o token ou expressão esperado; o parser tenta recuperar em outro comando. |
| E3002 | Incompatibilidade de tipo: era esperado '%s' mas foi recebido '%s'. | Use um tipo compatível com o contrato declarado. |
| W4001 | Captura externa de '%s' detectada: exigiria upvalues, recurso desabilitado por segurança. | Passe estado por parâmetros ou receptor explícito. |
| E4001 | A captura foi bloqueada; passe o valor como parâmetro explícito. | Capturas de ambiente são excluídas deliberadamente do perfil compilado. |
| E1002 | Arquivo fonte não contém UTF-8 válido. | Salve a fonte como UTF-8. |
| E1003 | Limite de aninhamento sintático excedido. | Divida expressões ou blocos profundamente aninhados. |
| E1005 | Literal numérico inválido ou fora do intervalo. | Literais inteiros exigem 64 bits; literais reais precisam ser finitos e representáveis em 64 bits. |
| E1004 | Limite 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. |
| E3001 | O símbolo '%s' não foi declarado. | Verifique escopo e grafia; funções não capturam ambientes externos. |
| E3011 | Campos 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. |
| E3012 | Construtor 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. |
| H3001 | Você quis dizer '%s'? | Sugestão determinística de nome visível no escopo. |
| W3001 | Código inalcançável após transferência de controle. | Remova ou reorganize a cauda que não executa. |
| W3002 | Função com retorno tipado pode terminar sem retornar valor; o retorno implícito é nulo. | Garanta um retorno nos caminhos relevantes. |
| E3101 | Divisão ou módulo por zero demonstrável em compilação. | O denominador é uma expressão constante igual a zero. |
| E3102 | Resultado 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. |
| E3104 | Incompatibilidade de tipo demonstrável: esperado '%s', recebido '%s'. | Contratos explícitos não são removidos pela otimização. |
| E3105 | Operação demonstravelmente inválida: %s. | Use os tipos e limites aceitos pelo runtime. |
| E3106 | Conversão literal inválida para '%s'. | Valide o texto de entrada ou trate dados recebidos em execução. |
| E3107 | Deslocamento constante fora do intervalo [0, 63]. | A quantidade de bits precisa estar dentro dos limites de 64 bits. |
| E3108 | O passo constante de uma fatia não pode ser zero. | Use um passo positivo ou negativo diferente de zero. |
| E3109 | Membro '%s' não existe em '%s'. | Verifique o nome do método, campo ou exportação disponível para este tipo. |
| E3110 | Não é possível modificar elemento de '%s' imutável. | Textos e tuplas são imutáveis; crie um novo valor ou utilize um vetor. |
| E3111 | Operação '%s' inválida sobre valor comprovadamente nulo. | Verifique se o valor não é nulo antes de acessar membros, indexar ou chamar. |
| E3112 | O valor do tipo '%s' não pode ser chamado como função. | Apenas funções, métodos e classes construtíveis podem ser invocados. |
| E3014 | Membro '%s' não é acessível neste contexto. | Respeite a visibilidade público, protegido ou privado da declaração que oculta as herdadas. |
| E3015 | Membro '%s' exige uma instância. | Instancie a classe antes de acessar campos e métodos de instância. |
| E3016 | A 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 | %s | O destino precisa ser modificável; funções, constantes e o receptor isto não podem ser reatribuídos. |
| E3201 | Funçã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. |
| E3013 | Destrutor 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. |
| E3301 | Construçã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. |
| E3302 | Aguardar exige Promessa | Uma operação síncrona não se torna assíncrona por aguardar. Use uma função assincrona ou rotina. |
| E3303 | Funçã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. |
| E3304 | Método não preserva o efeito assíncrono do contrato. | Implementação e override devem manter assincrona e o tipo de resultado declarado. |
| E3305 | Construção ainda não suportada no lowering assíncrono: %s. | A implementação incremental rejeita esta construção explicitamente; não há fallback bloqueante. |
| E3306 | Resultado vazio de aguardar não pode ser usado como valor. | Use aguardar como comando quando a Promise é Promessa |
| E3307 | Limite 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. |
| E3401 | Rotina 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. |
| E3402 | Funçã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. |
| E3403 | Rotina 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. |
| E3404 | Funçã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.